Skip to content

Commit 4ea55cd

Browse files
Lum1104claude
andcommitted
fix: address code review feedback — terminology consistency and URL path
- Replace "agent" with "subagent" in SKILL.md dispatch references (5 locations) - Add node_modules/.git/dist exclusions to Phase 0 find command - Fix design doc URL to include understand-anything-plugin/ prefix Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent aa4df6e commit 4ea55cd

File tree

2 files changed

+7
-7
lines changed

2 files changed

+7
-7
lines changed

docs/plans/2026-03-18-multi-platform-simple-design.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ Each platform gets an `INSTALL.md` that the AI agent can fetch and follow:
8282

8383
User tells the agent one line:
8484
```
85-
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.codex/INSTALL.md
85+
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/understand-anything-plugin/.codex/INSTALL.md
8686
```
8787

8888
The agent executes the clone + symlink/config automatically.

understand-anything-plugin/skills/understand/SKILL.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Determine whether to run a full analysis or incremental update.
5151
- Read the primary package manifest (`package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `pom.xml`) if it exists. Store as `$MANIFEST_CONTENT`.
5252
- Capture the top-level directory tree:
5353
```bash
54-
find $PROJECT_ROOT -maxdepth 2 -type f | head -100
54+
find $PROJECT_ROOT -maxdepth 2 -type f -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' | head -100
5555
```
5656
Store as `$DIR_TREE`.
5757
- Detect the project entry point by checking for common patterns: `src/index.ts`, `src/main.ts`, `src/App.tsx`, `main.py`, `main.go`, `src/main.rs`, `index.js`. Store first match as `$ENTRY_POINT`.
@@ -82,7 +82,7 @@ Pass these parameters in the dispatch prompt:
8282
> Project root: `$PROJECT_ROOT`
8383
> Write output to: `$PROJECT_ROOT/.understand-anything/intermediate/scan-result.json`
8484
85-
After the agent completes, read `$PROJECT_ROOT/.understand-anything/intermediate/scan-result.json` to get:
85+
After the subagent completes, read `$PROJECT_ROOT/.understand-anything/intermediate/scan-result.json` to get:
8686
- Project name, description
8787
- Languages, frameworks
8888
- File list with line counts
@@ -137,7 +137,7 @@ After ALL batches complete, read each `batch-<N>.json` file and merge:
137137

138138
### Incremental update path
139139

140-
Use the changed files list from Phase 0. Batch and dispatch file-analyzer agents using the same process as above, but only for changed files.
140+
Use the changed files list from Phase 0. Batch and dispatch file-analyzer subagents using the same process as above, but only for changed files.
141141

142142
After batches complete, merge with the existing graph:
143143
1. Remove old nodes whose `filePath` matches any changed file
@@ -194,7 +194,7 @@ Pass these parameters in the dispatch prompt:
194194
> [list of edges with type "imports"]
195195
> ```
196196

197-
After the agent completes, read `$PROJECT_ROOT/.understand-anything/intermediate/layers.json` to get the layer assignments.
197+
After the subagent completes, read `$PROJECT_ROOT/.understand-anything/intermediate/layers.json` to get the layer assignments.
198198

199199
**For incremental updates:** Always re-run architecture analysis on the full merged node set, since layer assignments may shift when files change.
200200

@@ -247,7 +247,7 @@ Pass these parameters in the dispatch prompt:
247247
> [imports and calls edges]
248248
> ```
249249

250-
After the agent completes, read `$PROJECT_ROOT/.understand-anything/intermediate/tour.json` to get the tour steps.
250+
After the subagent completes, read `$PROJECT_ROOT/.understand-anything/intermediate/tour.json` to get the tour steps.
251251

252252
---
253253

@@ -296,7 +296,7 @@ Pass these parameters in the dispatch prompt:
296296
> Read the file and validate it for completeness and correctness.
297297
> Write output to: `$PROJECT_ROOT/.understand-anything/intermediate/review.json`
298298

299-
3. After the agent completes, read `$PROJECT_ROOT/.understand-anything/intermediate/review.json`.
299+
3. After the subagent completes, read `$PROJECT_ROOT/.understand-anything/intermediate/review.json`.
300300

301301
4. **If `approved: false`:**
302302
- Review the `issues` list

0 commit comments

Comments
 (0)