Compound

/compound - Knowledge Compounding

After a sprint or a significant fix, extract what you learned into structured, searchable documents. Next time the agent plans or reviews, it finds these automatically.

Telemetry preamble

Defensive telemetry init. No-op if telemetry is disabled via NANOSTACK_NO_TELEMETRY=1, ~/.nanostack/.telemetry-disabled, or if the helpers are removed.

_P="$HOME/.claude/skills/nanostack/bin/lib/skill-preamble.sh"
[ -f "$_P" ] && . "$_P" compound
unset _P

When to run

• After /ship completes a sprint
• After fixing a bug that took significant investigation
• After making an architecture decision worth remembering
• After discovering a pattern that should be reused

Process

1. Read the sprint artifacts

Resolve all sprint phase artifacts in one call:

~/.claude/skills/nanostack/bin/resolve.sh compound

The output is JSON with upstream_artifacts containing paths for think, plan, review, security, qa, and ship artifacts (only those that exist within the last 2 days). Read what's available. Focus on:

• /review findings that were fixed (these are bugs worth documenting)
• /security findings that were resolved (these are patterns worth remembering)
• /think scope decisions (these are decisions worth recording)
• /qa failures that were debugged (these are bugs with investigation trails)

Report-only ship check. Read the ship artifact's run_mode. If it is "report_only", /ship only previewed the delivery and nothing was published (no commit, no PR, no deploy). Tell the user plainly that the ship was report-only, then keep going: the investigation from /review, /security, and /qa is still worth capturing if it was non-trivial. But do not write a solution or summary that claims work was shipped or that the sprint closed. There is no shipment to record yet.

SHIP_ARTIFACT=$(~/.claude/skills/nanostack/bin/resolve.sh compound 2>/dev/null | jq -r '.upstream_artifacts.ship // empty')
SHIP_RUN_MODE=$(jq -r '.run_mode // "normal"' "$SHIP_ARTIFACT" 2>/dev/null || echo "normal")

2. Identify what's worth capturing

Not everything needs a solution document. Capture:

• Bugs that took more than a trivial fix (the investigation is the value)
• Patterns you want the agent to follow in future sprints
• Architecture decisions with trade-offs that someone might question later

Skip:

• Typos, formatting, trivial fixes
• Standard library usage (the docs are better)
• Findings that were auto-fixed with no investigation

3. Check for existing solutions

Before creating a new document, search for related ones:

~/.claude/skills/nanostack/bin/find-solution.sh "relevant keywords"
~/.claude/skills/nanostack/bin/find-solution.sh --tag relevant-tag
~/.claude/skills/nanostack/bin/find-solution.sh --file affected/file/path

If a closely related solution exists:

• Update it if the new information extends or corrects the existing document
• Create a new one if it's a different problem that happens to share keywords

Do not create duplicates. One good document beats two partial ones.

When updating an existing solution, evolve it:

1. Rewrite the compiled truth. Read the current Problem, Solution, and Prevention sections. Do they reflect what you know NOW, or what you knew when the document was created? If the new sprint changed your understanding, rewrite these sections completely — don't append to them. The compiled truth must always reflect the current best understanding, not a history of partial fixes.
2. Increment applied_count in the frontmatter
3. Set validated: true and last_validated to today's date
4. Adjust confidence (1-10 scale): if the solution worked perfectly this sprint → set to current + 2 (cap 10). If it worked with adjustments → keep current. If it failed or needed major changes → set to current - 2 (floor 1). Confidence determines search ranking: high-confidence solutions surface first.
5. Append a ### YYYY-MM-DD — Context entry to the ## History section at the bottom, documenting what happened in this sprint and what changed

Compiled truth is rewritten. Timeline is appended. The sections above History always reflect the latest understanding. The History section is the immutable evidence trail of how that understanding evolved. If old information was wrong, rewrite the compiled truth — don't leave stale text. The History entry records what changed and why.