ZeroHuman
◈

Artifacts

artifact.json

Create immutable records of what was produced and how.

Artefacts are immutable records correlated with tracing. They capture what was produced (docs, code patches, configs, exports), which profile/skills/tools/policies were involved, what approvals were granted, and measurable outcomes. Artefacts are the backbone for auditability and for evals that score both outcomes and process compliance.

Schema

artifact.jsonyaml
{
  "artifact": {
    "id": "art_2024011514300001",
    "type": "code_change",
    "status": "pending_review",
    "created_by": "senior-react-developer",
    "created_at": "2024-01-15T14:30:00Z",

    "summary": "Refactored CartSummary component for performance",
    "description": "Wrapped CartSummary in React.memo with custom comparator. Extracted price calculation to useMemo. Reduced re-renders from 12/s to 2/s.",

    "files_changed": [
      "src/components/CartSummary.tsx",
      "src/components/CartSummary.test.tsx"
    ],

    "metrics": {
      "render_count_before": 12,
      "render_count_after": 2,
      "bundle_size_delta": "-0.3kb",
      "test_coverage": "94%"
    },

    "lineage": {
      "task_id": "task_checkout_refactor",
      "profile": "senior-react-developer",
      "capability": "frontend-development",
      "skills_used": ["react-optimization", "performance-profiling"],
      "tools_used": ["run-tests", "bundle-analyzer"],
      "policy_checks_passed": ["code-quality-standards"]
    },

    "review": {
      "required": true,
      "reviewers": ["tech-lead"],
      "approved": false
    }
  }
}

Usage

# Artifacts create an audit trail
# Every significant output is tracked with:
# - Who created it (profile)
# - What was used (skills, tools, capabilities)
# - What policies were checked
# - What the measurable outcome was

Best Practices

  • ✓Capture metrics and measurable outcomes in every artifact
  • ✓Include full lineage — skills, tools, and policies used
  • ✓Require review for artifacts that modify production systems
  • ✓Use consistent artifact IDs for traceability
  • ✓Store artifacts in version control alongside the work

Anti-Patterns

  • ✗Artifacts without lineage — cannot audit what happened
  • ✗Missing metrics — cannot measure impact
  • ✗No review process for critical changes
  • ✗Artifacts that are too verbose to be useful