alexion
596ba36fdb
/consume is the write-side counterpart to the read-only /wiki: it mines a target for generalized, transferable knowledge and files atomic concept notes into 01 sources/claude/, the agent-owned area of the Obsidian vault. It is user-invoked/deliberate. SKILL.md holds the branch-detection ladder plus the common writing logic — read existing knowledge (via /wiki and a direct scan), plan atomic generalized notes with a file-to-section-to-note contribution map, present an HTML plan and wait for explicit approval, then write on the vault's note template and clear the consumed scaffolding. v1 ships one branch, project.md: source code is truth for current state, while .claude/spec and .claude/tasks are the record of why (mined, then deleted). The ladder is extensible for future source types.
1.6 KiB
project branch
How consume reads a project target, and what it clears afterward.
Reached from step 1 of SKILL.md when the target is a directory containing .claude/spec/ and/or .claude/tasks/.
Read the source, mine the specs
The source code is the truth for what the project is and does now. Read it thoroughly enough to understand its current state and to surface the reusable ideas it embodies — techniques, patterns, decisions, gotchas.
.claude/spec/ and .claude/tasks/ are the record of why — the reasoning, trade-offs, and intent behind what the code became.
They are the richest source of the generalizable lessons, and cleanup destroys them, so mine their reasoning now or lose it.
But they are not current fact: where a spec or task disagrees with the source, the source wins, and where one describes work later abandoned or changed, the source is what actually happened.
Together these are the raw material the writing logic generalizes; extracting the generalized notes themselves is step 4 of SKILL.md, not this branch's job.
Done when you understand the project's current state from its source and have mined its specs and tasks for the reasoning behind it.
Cleanup
After the notes are written (step 6 of SKILL.md), delete the spec and task files that were present under .claude/spec/ and .claude/tasks/ when you read the project in step 2 — the scaffolding this run consumed.
A file added after that read is not swept up.
Leave the now-empty .claude/spec/ and .claude/tasks/ directories in place, along with everything else under .claude/.