what's next.
Every roadmap item is a tracked GitHub issue. Comment, react, or open a PR — coograph is MIT and the issue tracker is the only roadmap.
Highest leverage.
- #001 high
/coograph-doctor — install health check skill
Sibling skill that audits a coograph-initialized project. Verifies graph.db, MCP wiring, _TBD_ markers, per-tool config, git hooks. Same 8-tool unification pattern as init.
Currently no way to verify install health post-init. Failures show up as silent context loss during agent sessions.
view on github - #002 high
Cross-tool invocation drift check
Pre-commit + CI script that asserts every per-tool config file points at the canonical SKILL.md. Already drifted twice in the rename pass.
Eight config files for eight tools. Without a check, "fixed README, forgot Aider" is the default failure mode.
view on github
On deck.
- #003 medium
Compatibility matrix — minimum tool versions
README table listing the minimum tested version for every supported tool plus the failure mode below it. Codex CLI v0.128 already triggered a regression.
Silent failures on older builds with no in-doc explanation.
view on github - #004 medium
Idempotent re-init — preserve filled placeholders
Detect partial state in step 1 of the init skill. Never overwrite user-customized instruction files. Update mode only patches tool config when adding a new tool.
Second run risks wiping stack details the user already filled in.
view on github - #005 medium
examples/ — finished init samples
Three reference projects at repo root: Next.js, Django, Go. Fully filled instruction files, no _TBD_ markers. Linked from Quick Start.
No concrete reference for what a coograph-initialized repo looks like for a real stack.
view on github - #009 medium
Unify skill names under /coograph-* namespace
Rename openspec-propose/apply/archive/explore + new-ticket + rebuild-code-graph to coograph-* prefix. Single autocomplete namespace. Bundle with #2 (drift checker).
Slash autocomplete is split across two prefixes. openspec-explore is also miscategorized — explore is general codebase search, not an OpenSpec phase.
view on github
Lower priority.
- #006 low
Pre-commit — frontmatter, markdown lint, link checker
Validate skill frontmatter (name, description), markdownlint, lychee for relative links. Catches broken skills before they ship.
Currently no automated checks on the markdown that powers the entire system.
view on github - #007 low
README — Codex CLI quirks section
Document why /coograph-init does not work in Codex CLI: slash reserved for built-ins, custom skills use $name or auto-trigger from description. Marked good first issue.
Hit by every Codex CLI user the first time. No in-doc explanation.
view on github
Done.
- #008 shipped
log-bash — extend audit trail beyond Claude Code
Audit hooks now ship for Claude Code, Codex CLI, and OpenCode — all three write to a unified .coograph/session.log + .coograph/sessions/<sid>.log. The five remaining tools (VS Code Copilot, Cursor, Windsurf, Aider, Cline) have no public hook API; documented honestly in the README.
Hard to debug failed sessions on Codex CLI, OpenCode, Cursor when we cannot see what the agent actually ran.
Unified path migration .claude/session.log → .coograph/session.log shipped same drop. Backed by blog post: /blog/2026-05-17-per-session-audit-logs-for-ai-coding-agents/
view on github
Want to help?
Open a PR against any of these issues and reference the number in the commit. Bug reports and proposals welcome — coograph treats GitHub issues as the only roadmap, so file there first.
Looking for an easy entry point? Issue #007 is tagged good first issue.