Skip to main content
AI/MLjmagly

build-artifact-index

Build or rebuild the SDLC artifact index for agent-navigable discovery

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--build-artifact-index
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/frameworks/sdlc-complete/skills/build-artifact-index/SKILL.md -o .claude/skills/build-artifact-index.md

Drops the SKILL.md into .claude/skills/build-artifact-index.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Build Artifact Index

Task

Build or refresh the artifact index that powers aiwg index query, aiwg index deps, and aiwg index stats. This is the entry point for ensuring agents can discover and navigate project artifacts efficiently.

Behavior

Primary: Use aiwg index build

# Standard rebuild (incremental)
aiwg index build

# Full rebuild (ignore cache)
aiwg index build --force

# With progress output
aiwg index build --verbose

Report what changed: new artifacts indexed, updated, unchanged, and removed counts.

Archived Query Answers

The index includes files in .aiwg/working/answers/ automatically. These are answers persisted by the archive-answer skill and appear in query results and dependency graphs alongside permanent artifacts. Their status: working frontmatter field signals they are candidates for promotion to a permanent destination (e.g., .aiwg/architecture/, .aiwg/reports/). Use the index to find stale working answers that should be promoted or discarded.

Fallback: Manual Digest Generation

If aiwg index build is not available (CLI not installed), fall back to manual scanning:

  1. Walk .aiwg/ for all artifact files
  2. Extract titles and short summaries from frontmatter/headings
  3. Write digest files to .aiwg/working/digests/
  4. Generate or update _index.yaml with paths, summaries, and timestamps

Post-Build Verification

After building, verify the index is healthy:

aiwg index stats --json

Report total artifacts indexed, coverage by phase, and any orphaned artifacts.

When to Run

  • After creating new SDLC artifacts
  • After modifying existing artifact references
  • At the start of a new SDLC phase
  • When aiwg index query returns stale results

References

  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/artifact-discovery.md — Agent protocol rules
  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/skills/artifact-lookup/SKILL.md — Query skill
  • @$AIWG_ROOT/src/artifacts/cli.ts — CLI implementation