Home Explore Help
Sign In
logic855
/
claude-mods
mirror of https://github.com/0xDarkMatter/claude-mods.git
1
0
Fork 0
Files Issues 0 Wiki
Tree: effaabe72b
Branches Tags
claude-mods
/
docs
/
PLAN.md

PLAN.md 3.6 KB
History Raw

Claude-Mods: Project Plan & Roadmap

Goal: A centralized repository of custom Claude Code commands, agents, and skills that enhance Claude Code's native capabilities with persistent session state, specialized expert agents, and streamlined workflows.

Created: 2025-11-27 Last Updated: 2026-06-10 Status: Active Development

Historical record of what shipped lives in CHANGELOG.md and the README "Recent Updates" section. This file only tracks what's next.

Current Inventory

Component Count Notes
Agents 12 Domain experts without skill twins + git-agent background worker
Skills 81 Operational skills, CLI tools, workflows, diagnostics, security
Commands 2 Session management (sync, save)
Rules 7 cli-tools, commit-style, naming-conventions, prompt-injection, skill-agent-updates, supply-chain, worktree-boundaries
Output Styles 13 Vesper, Spartan, Mentor, Executive, Pair, Atlas, Coach, Harbour, Meridian, Noir, Roast, Sage, Scout
Hooks 11 lint, format, safety, uv, install-scan, manifest-scan, pmail, unicode-scan ×2, config-change guard, worktree guard

Counts are enforced by the CI doc-drift gate (see roadmap) — if this table rots, CI fails.

Active Roadmap (June 2026 strategic review)

Phase 1 — Hygiene & truth (v2.11)

  • README skill/hook/rule tables match disk (24 missing skills added)
  • Remove ghost references (rules/thinking.md, docs/DASH.md)
  • Rename tests/skills/functional/git-workflow.* → git-cli-tools.*
  • CHANGELOG.md (keep-a-changelog format, seeded from Recent Updates)
  • CI: doc-drift gate (counts on disk vs README claims, ghost-link check)
  • CI: run every skills/*/tests/run.sh behavioural suite

Phase 2 — Skills-first restructure (v3.0)

  • Agent cull: deprecated 11 experts with -ops skill twins (python, typescript, javascript, go, rust, react, vue, astro, laravel, sql, postgres). Unique content folded into twin skills; dispatching skills now route general-purpose agents with skill preloading. 23 → 12 agents.
  • claude-code-ops: merged + refreshed claude-code-debug / claude-code-headless / claude-code-hooks against current official docs (30-event hook catalog, current skill frontmatter, current CLI flags).
  • New skills: claude-api-ops (Messages API, tool use, caching, Agent SDK), playwright-ops, terraform-ops.

Phase 3 — Distribution & native-feature adoption

  • Submit to community marketplace (claude.ai/settings/plugins/submit)
  • Reposition /save + /sync as portable/team-shareable state (native auto-memory covers single-machine context)
  • Adopt new hook events: ConfigChange guard (worm-persistence IOCs on settings edits) + worktree guard (worktree-boundaries enforcement). Note: ConfigChange payload carries source-not-path, so VS Code settings stay covered by integrity-audit.sh instead.
  • Auto-wire security hooks via plugin hooks/hooks.json (skill-scoped hooks only fire while a skill is active, so plugin level is the right layer)
  • fleet-ops v2: repositioned as landing discipline (queue, test gate, scrub, revert) on top of native agent teams / background agents; new fleet track registers natively-spawned branches

Open Questions

  • Should output styles be repositioned as "persona kits"? (still natively supported, but de-emphasized)
  • Skill description budget at 80+ skills — document skillOverrides guidance?

Guiding Principle

The best enhancements solve problems you've already felt. Follow the pain.