OpenSkillIndex← back to search
claude-code

Aiwg archive-answer

Capture a query answer and file it as a persistent artifact in .aiwg/working/answers/ with promotion guidance to a permanent destination.

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/.agents/skills/archive-answer" ~/.claude/skills/jmagly-aiwg-archive-answer && rm -rf "$T"
manifest: .agents/skills/archive-answer/SKILL.md
source content

archive-answer

Capture a query result or substantive chat answer and persist it as a structured artifact so it survives beyond the current session.

Triggers

  • "save this answer" → archive current response
  • "persist that result" → write answer to working directory
  • "archive this" → file as artifact with frontmatter
  • "keep this for later" → save with promotion suggestion
  • --archive-answer
    flag on 
    artifact-lookup
    → automatic post-query archival

Parameters

<title>
(required)

A short, descriptive title for the archived answer. Used as the filename slug and the 

title
field in frontmatter.

--content <text>
(optional)

The answer body to persist. If omitted, the skill uses the most recent substantive assistant response in the current conversation.

--source-query <query>
(optional)

The query or question that produced this answer. Stored in frontmatter for traceability.

--tags <tag,...>
(optional)

Comma-separated tags for the artifact. The skill also infers tags from content type (e.g., 

architecture
, 
security
, 
requirements
).

--dest <path>
(optional)

Override the suggested permanent destination. If omitted, the skill infers the destination from content type (see Destination Routing below).

Behavior

1. Write to Working Directory

Create a markdown file at 

.aiwg/working/answers/<slug>.md
:

.aiwg/working/answers/
└── <slug>.md

The slug is the title lowercased with spaces replaced by hyphens and non-alphanumeric characters stripped (e.g., "Auth flow analysis" → 

auth-flow-analysis.md
).

2. Frontmatter Format

---
title: "<title>"
date: "<YYYY-MM-DD>"
source-query: "<original query or empty>"
tags: [<inferred and explicit tags>]
status: working
promoted-to: ~
---

3. Destination Routing

After writing, suggest a permanent destination based on content signals:

Content signalsSuggested destination
architecture, SAD, ADR, design
.aiwg/architecture/
security, threat, vulnerability, CVE
.aiwg/security/
test, coverage, regression, QA
.aiwg/testing/
risk, mitigation, impact
.aiwg/risks/
requirement, use case, story
.aiwg/requirements/
deployment, runbook, ops
.aiwg/deployment/
report, summary, metrics
.aiwg/reports/
(no strong signal)
.aiwg/reports/

Tell the user: "Archived to 

.aiwg/working/answers/<slug>.md
. When ready to promote, move it to 
<suggested-dest>
and update 
status: promoted
and 
promoted-to: <final-path>
."

4. Index Refresh

After writing, note that the artifact will be picked up on the next index build:

aiwg index build

The 

build-artifact-index
skill scans 
.aiwg/working/answers/
and includes these files in the project graph.

Output Example

Archived: .aiwg/working/answers/auth-flow-analysis.md

Frontmatter:
  title: Auth flow analysis
  date: 2026-04-12
  source-query: "how does the current auth flow handle token refresh?"
  tags: [architecture, security, auth]
  status: working

Suggested destination: .aiwg/architecture/
When promoted, run: aiwg index build

Integration

  • artifact-lookup calls this skill when 
    --archive-answer
    is passed or when it detects a substantive multi-paragraph result.
  • workspace-prune-working (when available) lists 
    .aiwg/working/answers/
    entries and offers to promote or discard them during working-directory cleanup.
  • build-artifact-index includes 
    .aiwg/working/answers/
    in the project graph index automatically.

References

  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/skills/artifact-lookup/SKILL.md — Query skill that triggers archival
  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/skills/build-artifact-index/SKILL.md — Index skill that picks up archived answers