Aiwg build-artifact-index

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

install

source · Clone the upstream repo

git clone https://github.com/jmagly/aiwg

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

T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/agentic/code/frameworks/sdlc-complete/skills/build-artifact-index" ~/.claude/skills/jmagly-aiwg-build-artifact-index-dc9fa8 && rm -rf "$T"

manifest: agentic/code/frameworks/sdlc-complete/skills/build-artifact-index/SKILL.md

source content

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

aiwg index build

is not available (CLI not installed), fall back to manual scanning:

Walk
```
.aiwg/
```
for all artifact files
Extract titles and short summaries from frontmatter/headings
Write digest files to
```
.aiwg/working/digests/
```
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