Stats
Actions
Available In
Tags
Plugin
cairn
Workflow kit for AI-assisted software projects — session journals, rolling todo punch list, autonomous-round cadence, and six-phase feature checklist. Pairs with ep-kit for structured proposals.
What's Inside
Slash Commands4
/cairn-init
/cairn-init
Scaffold cairn's workflow artefacts into the current project
/cairn-loop
/cairn-loop
Run the autonomous loop — one round, schedule next wakeup, repeat until stop criterion
/cairn-round
/cairn-round
Run one bounded autonomous-round cycle
/cairn-session
/cairn-session
Open or append to today's cairn session log
Agents3
autonomous-planner
/autonomous-planner
Read `docs/todo.md` + recent session journals + (optionally) project profile, and return a recommended next bounded task for an autonomous round or loop. Use at the start of each autonomous cycle to save main-agent context on task-selection reasoning. Returns a task candidate with rationale, the tasks considered and passed over, and any blockers that would prevent a bounded pickup.
prior-session-digest
/prior-session-digest
Read session journals under docs/sessions/ and return a compact summary — what shipped, what's parked for review, and load-bearing decisions from recent sessions. Use at session start to ground context without reading every full journal, or when the user asks "what happened last session?" or "what's still open from the last few rounds?"
review-runner
/review-runner
Run the review tools detected by the review-phase skill in parallel and return a structured verdict. Use to isolate reviewer-tool output (semgrep findings, codex recommendations, language-linter warnings) from the main agent's context. Returns pass/warn/fail per tool, a combined verdict, and a trimmed list of findings worth the main agent's attention.
Skills7
cairn-autonomous-loop
/autonomous-loop
Use when the user wants the agent to keep picking up tasks autonomously and repeat the round cycle until a stop criterion is met — "keep going while I sleep", "run autonomously until you hit a blocker or clear P1", "loop through the punch list". Runs one round, schedules the next wakeup, repeats. Enforces commit checkpoints (3-commit soft pause, 5-commit hard stop) so silent prolific output doesn't erode trust. For exactly one cycle, use cairn-autonomous-round instead.
cairn-autonomous-round
/autonomous-round
Use when the user wants ONE bounded autonomous cycle — pick a task from docs/todo.md, implement, gate, commit, hand control back. Not a loop; one round and done. Triggers on phrases like "do one task from the punch list", "pick one thing and run it", "finish the Kanban refactor autonomously" when scoped to a single item. For repeating "keep going until I stop you" mode, use the cairn-autonomous-loop skill instead.
cairn-build-project-profile
/build-project-profile
Use to maintain the project profile at docs/project-profile.md — declarative statement of the project's values, risk tolerance, security posture, quality bar, and contribution norms. Triggers when the project settles a stance on a cross-cutting concern (e.g., "we don't mock databases in tests", "pre-1.0, no backwards-compat shims", "security posture is paranoid about injection"). Tracked in git; shared with all contributors. Updated in-place as part of normal PR workflow, NOT synthesis of individual sessions.
cairn-build-user-profile
/build-user-profile
Use to maintain the global user profile at ~/.config/cairn/user-profile.md (or the project-local path if install configured one). Triggers when the user reveals durable preferences about how they think, decide, or collaborate — editor choices, decision patterns, architectural instincts, pushback to AI framing, etc. Observations go in with evidence; the file is periodically re-synthesised, not blindly appended. Distinct from build-project-profile which captures the project's stances.
cairn-close-session
/close-session
Use when a session is ending — the user says "that's enough for today", "let's wrap up", "stop here", "close the session"; or when the agent itself judges the session is at a natural stopping point and wants to leave a clean handoff. Produces the end-of-session ritual — final journal entry, commit-status snapshot, handoff summary with concrete SHAs and explicit yes/no questions for the next session, and optional memory updates for durable preferences revealed during the session.
Stats
Version1.0.0
LanguageShell
Stars1
MaintenanceExcellent
LicenseApache-2.0
Last Commit
Added
Available In
Safety Signals
Caution
Uses power tools
Uses Bash, Write, or Edit tools
Tags
Categories
