feat(agents): make skill metadata agent-agnostic

This commit is contained in:
2026-07-29 22:39:02 -04:00
parent 40b37281d5
commit b541251f98
21 changed files with 131 additions and 80 deletions

View File

@@ -0,0 +1,17 @@
# Consume writes the target's push channel, not only the vault
`consume` was scoped to write only inside the vault's `01 sources/claude/` area.
A real run showed that most mined knowledge is not wiki-shaped — specific residue and proactive rules belong in the target's own always-loaded `AGENTS.md` — and dropping it lost real signal, while redoing the target-doc edits by hand after each run was toil.
We decided `consume` writes a second channel outside the vault, the target's `AGENTS.md`, rather than only planning those edits for the user to apply.
## Considered Options
- **Plan-only** — spell the target-doc edits out in the report and have the user apply them by hand.
Rejected: the whole value is not redoing what the run already worked out.
- **Auto-write both channels (chosen)** — apply the target edits too, but present them as a distinct, independently-approvable write-set under the one plan-approval gate, so a write outside the vault is never a surprise.
## Consequences
`consume`'s blast radius now includes files outside the vault and outside the spec/task scaffolding it deletes.
The plan-approval gate is what keeps that safe: the target write-set is approved separately from the vault write-set, and a declined target write-set degrades to flagged suggestions.
Destructive edits to `AGENTS.md` are gated on capture — an entry is removed or trimmed only when its general part is present in the wiki.

View File

@@ -0,0 +1,5 @@
# Agent-neutral project surfaces
This repository uses `AGENTS.md` and `.agents/` as the canonical project instruction, context, ADR, spec, task, and project-local skill surfaces.
Claude Code compatibility remains through `CLAUDE.md` and `.claude/` shims because existing harnesses and skills still discover those paths.
The compatibility surfaces are pointers, not duplicate sources of truth, so future agents have one canonical place to read and update.