chamnan
01Plugin Claude Code
chamnan — one plugin that preserves a long-lived repository's engineering context, so an agent stops rediscovering the same work every session.
Plugin Claude Code
chamnan — one plugin that preserves a long-lived repository's engineering context, so an agent stops rediscovering the same work every session.
Plugin Claude Code
Makes a repository know itself and preserve the engineering context built while you work with it, so an agent stops rediscovering both. An architecture index and an impact map instead of scanning files; work state, session records and the decisions behind them instead of losing context between sessions; the procedures.
Agent
Adds a one-line opening comment to source files that have none, so the architecture index can say what each file does. Reads and edits only the files it is given. Dispatched by /chamnan:bootstrap when coverage is low.
Agent
Health-checks the .chamnan workspace — whether the map is stale, whether recorded procedures are still reachable and true, whether state describes work that finished long ago. Read-only; reports, never fixes.
Hook
Runs when a session starts, executing session_start.py. From ArcticFox2029/chamnan.
Hook
Runs after a tool call finishes for Bash, Write and Edit tool calls, executing scratch_watch.py. From ArcticFox2029/chamnan.
Hook
Runs when a session ends, executing session_end.py. From ArcticFox2029/chamnan.
Hook
Runs before the agent uses a tool for Read tool calls, executing bulk_read_notice.py. From ArcticFox2029/chamnan.
Skill Claude CodeCodex
Set up chamnan in this repository for the first time — build the architecture index, measure how well the code describes itself, fill in missing file comments, and record a baseline. Run once per repo.
Skill Claude CodeCodex
Write down a procedure worth keeping — a multi-step process, a trap that cost real time, or something that has now come up three times. Use it the moment you finish such a task, while the details are still exact.
Skill Claude CodeCodex
Record a change that reshaped the repository — what moved, why it was worth doing, and which areas it touched. Use after a migration, a rewrite, or a decision that changed how part of the system works.
Skill Claude CodeCodex
Turn a scratch script into a permanent tool this repo keeps. Use when a check, report, or analysis has proved worth running more than once.
Skill Claude CodeCodex
Rebuild the architecture index after files were added, removed, renamed, or restructured. Cheap to run; run it whenever the shape of the repo changed rather than waiting to be asked.
Skill Claude CodeCodex
Record why something is the way it is — a decision and its reasoning, a lesson that cost time, or a standing constraint. Use when the reasoning behind a choice would be expensive to reconstruct later.
Skill Claude CodeCodex
Show what this workspace has actually done to context cost in this repo — weekly context-per-turn, before and after. Use when the user asks whether chamnan is worth keeping.
Skill Claude CodeCodex
Write down where this stretch of work stopped, so the next session continues instead of restarting. Use at the end of a working session, or when handing the repository to someone else.