Claude-skill-registry artifact-tracking

Token-efficient tracking for AI orchestration. CLI-first for status updates (~50 tokens), agent fallback for complex ops (~1KB). Use when: updating task status, querying blockers, creating progress files, validating phases.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/artifact-tracking" ~/.claude/skills/majiayu000-claude-skill-registry-artifact-tracking-8c60f2 && rm -rf "$T"

manifest: skills/data/artifact-tracking/SKILL.md

Artifact Tracking Skill

Token-efficient tracking artifacts for AI agent orchestration.

Quick Operations (CLI First)

Operation	Command	Tokens
Mark complete	`python scripts/update-status.py -f FILE -t TASK-X -s completed`	~50
Batch update	`python scripts/update-batch.py -f FILE --updates "T1:completed,T2:completed"`	~100
Query pending	`python scripts/query_artifacts.py --status pending`	~50
Validate	`python scripts/validate_artifact.py -f FILE`	~50

Scripts location:

.claude/skills/artifact-tracking/scripts/

Agent Operations (When Needed)

For complex operations requiring judgment:

Operation	Agent	When to Use
CREATE file	artifact-tracker	New phase, need template
UPDATE complex	artifact-tracker	Blockers with context, decisions
QUERY synthesis	artifact-query	Cross-phase analysis, handoffs
VALIDATE quality	artifact-validator	Pre-completion checks

Agent invocation:

Task("artifact-tracker", "Create Phase 2 progress for auth-overhaul PRD")
Task("artifact-query", "Show all blocked tasks in auth-overhaul phases 1-3")

File Locations

Type	Location	Limit
Progress	`.claude/progress/[prd]/phase-N-progress.md`	ONE per phase
Context	`.claude/worknotes/[prd]/context.md`	ONE per PRD
Bug fixes	`.claude/worknotes/fixes/bug-fixes-YYYY-MM.md`	ONE per month
Observations	`.claude/worknotes/observations/observation-log-MM-YY.md`	ONE per month

Policy:

.claude/specs/doc-policy-spec.md

YAML Format (Source of Truth)

---
type: progress
prd: "prd-name"
phase: 2
status: in_progress
progress: 40

tasks:
  - id: "TASK-2.1"
    status: "pending"           # pending|in_progress|completed|blocked
    assigned_to: ["agent-name"] # REQUIRED for orchestration
    dependencies: []            # REQUIRED for orchestration
    model: "opus"               # Optional: opus|sonnet|haiku

parallelization:
  batch_1: ["TASK-2.1", "TASK-2.2"]  # Run parallel
  batch_2: ["TASK-2.3"]              # After batch_1
---

Token Efficiency

Operation	Traditional	Optimized	Savings
Task list	25KB	2KB	92%
Query blockers	75KB	3KB	96%
Status update	25KB	50 bytes	99.8%

Detailed References

Creating files:
```
./creating-artifacts.md
```
Updating tasks:
```
./updating-artifacts.md
```
Querying data:
```
./querying-artifacts.md
```
Validating:
```
./validating-artifacts.md
```
Orchestration:
```
./orchestration-reference.md
```
Best practices:
```
./best-practices.md
```
Common patterns:
```
./common-patterns.md
```
Format spec:
```
./format-specification.md
```
Templates:
```
./templates/
```
Schemas:
```
./schemas/
```