Skip to main content
AI/MLjmagly

archive-answer

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

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--archive-answer
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/archive-answer/SKILL.md -o .claude/skills/archive-answer.md

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

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 signals Suggested 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