Skip to content

Commit cc81305

Browse files
prosdevclaude
andcommitted
docs(plans): flesh out Phase 2 with research planner findings
Updated: - User stories: added US-4b (restart catchup), US-17 (multiple editors), cleaned deprecated stories, split US-4 into auto-watch vs restart - Parts reordered: spike first, then Linear Merge, simplify indexer, watcher, catchup, remove git/gh, status rework, E2E tests - Research identified: ~15-20 files to delete, ~12 to modify for git/gh removal - Key risk: verify Antfly Linear Merge exists in SDK before implementation - Scope: 2-3 days focused work, strict dependency chain between parts Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 1a2f566 commit cc81305

1 file changed

Lines changed: 26 additions & 15 deletions

File tree

.claude/da-plans/core/phase-2-indexing-rethink/user-stories.md

Lines changed: 26 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -22,16 +22,22 @@ when I run `dev index .`,
2222
I should see clear progress and have searchable code when it completes,
2323
so that I can immediately ask my AI tools about the codebase.
2424

25-
**US-4: Ongoing development**
25+
**US-4: Ongoing development (automatic)**
2626
As a developer actively writing code,
27-
when I save files and switch to my AI tool,
28-
my recent changes should be searchable without running any command,
29-
so that the AI always has current context.
27+
when I save a file,
28+
the MCP server's file watcher should detect the change and re-index automatically,
29+
so that the AI always has current context without me running any command.
30+
31+
**US-4b: MCP server restart catchup**
32+
As a developer whose MCP server restarted (editor restart, system reboot),
33+
when the MCP server starts back up,
34+
it should detect what changed while it was off and re-index only those files,
35+
so that I don't need a full re-index after every restart.
3036

3137
**US-5: Coming back to a project**
3238
As a developer returning to a project after days/weeks,
33-
when I run `dev index .` again,
34-
it should only process what changed (fast incremental),
39+
when the MCP server starts,
40+
it should catch up on all changes since last run (fast incremental),
3541
so that I'm not waiting for a full re-index.
3642

3743
**US-6: Large codebase**
@@ -60,19 +66,11 @@ when my AI tool calls `dev_search`,
6066
the exact function should be the top result (BM25 keyword match),
6167
so that exact lookups are instant and precise.
6268

63-
**~~US-10: Search git history~~ (DEPRECATED)**
64-
Git history is better served by `git log`, `git blame`, and AI tools running git
65-
commands directly. Removed in Phase 2.
66-
67-
**~~US-11: Search GitHub issues~~ (DEPRECATED)**
68-
GitHub issues/PRs are better served by GitHub's own MCP server and the `gh` CLI.
69-
Removed in Phase 2.
70-
7169
## Lifecycle
7270

7371
**US-12: No babysitting**
7472
As a developer using dev-agent day-to-day,
75-
I should never need to think about Antfly, servers, or background processes,
73+
I should never need to think about Antfly, servers, watchers, or background processes,
7674
so that dev-agent feels like a native part of my workflow.
7775

7876
**US-13: Transparent status**
@@ -98,3 +96,16 @@ so that search results are scoped to the right project.
9896
As a developer switching between projects in Cursor,
9997
dev-agent should automatically use the right index for the current workspace,
10098
so that I don't need to re-configure anything.
99+
100+
**US-17: Multiple editor windows**
101+
As a developer with two Cursor windows open on the same repo,
102+
both MCP server instances should work without conflicts,
103+
so that I don't get errors or corrupted data.
104+
105+
## Deprecated
106+
107+
The following were removed in Phase 2. Git history and GitHub issues are better
108+
served by their native tools (`git` CLI, `gh` CLI, GitHub MCP server).
109+
110+
- ~~US-10: Search git history~~ — use `git log`, `git blame`, AI can run git directly
111+
- ~~US-11: Search GitHub issues~~ — use GitHub MCP server, `gh` CLI, or Linear/Jira MCP

0 commit comments

Comments
 (0)