Skip to content

docs: update roadmap and AI agent guidance files #110

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
prosdev wants to merge 1 commit into from
Closed

docs: update roadmap and AI agent guidance files #110

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -179,10 +179,13 @@ Specialized agents for development tasks.

MCP server with built-in adapters for AI tools.

**Adapters:**
**Adapters (9 tools):**
- **SearchAdapter:** Semantic code search (`dev_search`)
- **RefsAdapter:** Relationship queries - callers/callees (`dev_refs`)
- **MapAdapter:** Codebase structure with change frequency (`dev_map`)
- **HistoryAdapter:** Semantic git commit search (`dev_history`)
- **StatusAdapter:** Repository status (`dev_status`)
- **PlanAdapter:** Planning from issues (`dev_plan`)
- **PlanAdapter:** Context assembly for issues (`dev_plan`)
- **ExploreAdapter:** Code exploration (`dev_explore`)
- **GitHubAdapter:** Issue/PR search (`dev_gh`)
- **HealthAdapter:** Server health checks (`dev_health`)
Expand Down
23 changes: 13 additions & 10 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -154,16 +154,19 @@ dev mcp install

That's it! Claude Code now has access to all dev-agent capabilities.

### Available Tools in Claude Code & Cursor

Once installed, AI tools gain access to these powerful capabilities:

- **`dev_search`** - Semantic code search across indexed repositories
- **`dev_status`** - Repository indexing status and health information
- **`dev_plan`** - Generate implementation plans from GitHub issues
- **`dev_explore`** - Explore code patterns, find similar code, analyze relationships
- **`dev_gh`** - Search GitHub issues and pull requests with semantic context (auto-reloads on index changes)
- **`dev_health`** - Check MCP server health and component status (vector storage, repository, GitHub index)
### Available Tools in Claude Code & Cursor (9 tools)

Once installed, AI tools gain access to:

- **`dev_search`** - Semantic code search (USE THIS FIRST for conceptual queries)
- **`dev_refs`** - Find callers/callees of functions (for specific symbols)
- **`dev_map`** - Codebase structure with component counts and change frequency
- **`dev_history`** - Semantic search over git commits (who changed what and why)
- **`dev_plan`** - Assemble context for GitHub issues (code + history + patterns)
- **`dev_explore`** - Find similar code, trace relationships
- **`dev_gh`** - Search GitHub issues/PRs semantically
- **`dev_status`** - Repository indexing status
- **`dev_health`** - Server health checks

### MCP Command Reference

Expand Down
26 changes: 24 additions & 2 deletions PLAN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -213,7 +213,7 @@ Git history is valuable context that LLMs can't easily access. We add intelligen

> Building on git history with deeper insights.

### Tasks
### Git Tasks

| Task | Priority | Status |
|------|----------|--------|
Expand All @@ -222,6 +222,28 @@ Git history is valuable context that LLMs can't easily access. We add intelligen
| Contributor expertise mapping | 🟢 Low | 🔲 Todo |
| Cross-repo history | 🟢 Low | 🔲 Todo |

### Tool Improvements

| Task | Rationale | Priority | Status |
|------|-----------|----------|--------|
| Generalize `dev_plan` → `dev_context` | Currently requires GitHub issue; should work with any task description | 🔴 High | 🔲 Todo |
| Freeform context assembly | `dev_context "Add rate limiting"` without needing issue # | 🔴 High | 🔲 Todo |
| Multiple input modes | `--issue 42`, `--file src/auth.ts`, or freeform query | 🟡 Medium | 🔲 Todo |

**Why:** `dev_plan` is really a context assembler but is tightly coupled to GitHub issues. Generalizing it:
- Works without GitHub
- Easier to benchmark (no real issues needed)
- Name matches function (assembles context, doesn't "plan")
- More useful for ad-hoc implementation tasks

### Benchmark Improvements

| Task | Rationale | Priority | Status |
|------|-----------|----------|--------|
| Add implementation task types | Current benchmark only tests exploration; missing `dev_plan`/`dev_gh` coverage | 🟡 Medium | 🔲 Todo |
| Generic implementation patterns | "Add a new adapter similar to X" — tests pattern discovery | 🟡 Medium | 🔲 Todo |
| Snapshotted issue tests | Capture real issues for reproducible `dev_plan` testing | 🟢 Low | 🔲 Todo |

---

## Future: Extended Intelligence (v0.6+)
Expand Down Expand Up @@ -347,4 +369,4 @@ pnpm test

---

*Last updated: November 2025*
*Last updated: November 29, 2025 at 01:42 PST*
Loading