◈
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 wasBest 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