~ / rigs / alegauss / roadkeep

alegauss/roadkeep

Keeps a project's roadmap, changelog, improvements and strategy files to one format - a schema at the point of insertion, not a linter after the fact. Python CLI + Claude Code plugin.

↗ GitHub ★ 1 Apache-2.0 updated 4d ago project Claude Code Claude plugin
share on X
ARCHETYPE
Automator
Hooks on every lifecycle event: format, lint, notify, log.
CONTEXT TAX · EVERY TURN
up to ~8.6k tokens
Claude Code loads MCP tools on demand, so the real cost is usually lower.
Heavy · median rig: 2.3k · breakdown
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details
Quality 15/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ npx degit alegauss/roadkeep/.claude ./rig-roadkeep  # inspect, then merge into .claude/

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ npx degit alegauss/roadkeep/.claude/skills/roadkeep-dev .claude/skills/roadkeep-dev
$ npx degit alegauss/roadkeep/gui/.claude/skills/audit .claude/skills/audit
$ npx degit alegauss/roadkeep/gui/.claude/skills/roadkeep-gui-roadmap-docs .claude/skills/roadkeep-gui-roadmap-docs
$ npx degit alegauss/roadkeep/gui/.claude/skills/roadkeep .claude/skills/roadkeep
$ npx degit alegauss/roadkeep/gui/.claude/skills/screens .claude/skills/screens
$ npx degit alegauss/roadkeep/gui/.claude/skills/viglet-ds-pages .claude/skills/viglet-ds-pages
$ curl -fsSL --create-dirs -o .claude/agents/scanner.md https://raw.githubusercontent.com/alegauss/roadkeep/main/gui/.claude/agents/scanner.md
$ curl -fsSL --create-dirs -o .claude/agents/verifier.md https://raw.githubusercontent.com/alegauss/roadkeep/main/gui/.claude/agents/verifier.md

Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "python \"${CLAUDE_PROJECT_DIR}/.claude/hooks/no-clobber.py\""
          }
        ]
      },
      {
        "matcher": "Edit|MultiEdit|NotebookEdit|Write|Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python \"${CLAUDE_PROJECT_DIR}/.claude/hooks/roadkeep-launch.py\" guard"
          }
        ]
      }
    ]
  }
}

MCP servers (2)

serversourceest. tokens
roadkeep local / custom 2.5k
playwright local / custom 2.5k

Skills (6)

Subagents (2)

scanner
model: sonnet
Scans one partition of roadkeep-gui for defects and boundary leaks the gates cannot see. Reports only — never fixes, never edits, never runs a command.
verifier
model: opus
Judges roadkeep-gui audit output and changes nothing. FINDINGS mode classifies each scanner finding as CONFIRMED, FALSE POSITIVE or UNVERIFIABLE by running the project's real gates; ROADMAP mode check

Hooks (4)

eventmatcherruns
SessionStart*python "${CLAUDE_PROJECT_DIR}/.claude/hooks/roadkeep-launch.py" guard
PreToolUseWritepython "${CLAUDE_PROJECT_DIR}/.claude/hooks/no-clobber.py"
PreToolUseEdit|MultiEdit|NotebookEdit|Write|Bashpython "${CLAUDE_PROJECT_DIR}/.claude/hooks/roadkeep-launch.py" guard
Stop*python "${CLAUDE_PROJECT_DIR}/.claude/hooks/roadkeep-launch.py" guard

Plugins (1)

roadkeep@alegauss

Permissions

deny (0)
—
ask (0)
—
allow (3)
Bash(python .roadkeep/scripts/roadkeep.py:*)
Bash(python "${CLAUDE_PROJECT_DIR}/.roadkeep/scripts/roadkeep.py":*)
Edit(/.claude/skills/roadkeep-gui-roadmap-docs/**)

Similar rigs

copied ✓