Compound

Capture the most valuable insights from a coding session and save them as reusable reference documents.

Usage

/act:workflow:compound [optional context]

Arguments (all optional):

Title hint: "auth middleware rewrite"
File paths: ai_specs/auth-plan.md
Work type hint: "feature", "refactor", "bug"

What it does

Collects context — gathers information from the current session, optional arguments, and referenced files
Extracts insights — identifies decisions, tradeoffs, patterns, and pitfalls from the session
Synthesizes — creates a compact, scannable document focused on transferable learning
Saves — writes to ai_docs/solutions/<category>/<slug>.md

Category	Use for
`feature-delivery`	New features shipped end-to-end
`bug-fixes`	Bugs diagnosed and resolved
`refactors`	Code restructuring and cleanup
`performance`	Performance improvements
`testing`	Testing strategy and infrastructure
`tooling`	Build, CI, and developer tooling
`architecture`	Architectural decisions and patterns
`investigations`	Research and analysis
`cross-cutting`	Insights spanning multiple categories

Document structure

Each compound document includes:

---
title: Short descriptive title
date: 2026-03-17
work_type: feature
tags: [auth, middleware, riverpod]
confidence: high
references: [ai_specs/auth-plan.md]
---

## Summary
What was accomplished and why it matters.

## Reusable Insights
Key patterns, decisions, and lessons that transfer to future work.

## Decisions (optional)
Choices made and alternatives considered.

## Pitfalls (optional)
What went wrong and how it was resolved.

When to use it

After completing a feature with /act:workflow:work
After a complex debugging session
After a significant refactor
Any time you learn something worth documenting for future sessions

Why it matters

Future sessions can reference compound documents for context. Instead of re-learning the same lessons, the AI starts with your accumulated insights:

“Last time we set up auth, we used this pattern because…”
“This pitfall was encountered before — here’s how to avoid it…”
“The team decided on this approach for these reasons…”

/act:workflow:work — the command you typically run before compound
/act:workflow:spec — start a new feature cycle