phase2-explore.md

 1# Phase 2: Explore Repository
 2
 3You are analyzing a codebase to understand its structure before reviewing documentation impact.
 4
 5## Objective
 6Produce a structured overview of the repository to inform subsequent documentation analysis.
 7
 8## Instructions
 9
101. **Identify Primary Languages and Frameworks**
11   - Scan for Cargo.toml, package.json, or other manifest files
12   - Note the primary language(s) and key dependencies
13
142. **Map Documentation Structure**
15   - This project uses **mdBook** (https://rust-lang.github.io/mdBook/)
16   - Documentation is in `docs/src/`
17   - Table of contents: `docs/src/SUMMARY.md` (mdBook format: https://rust-lang.github.io/mdBook/format/summary.html)
18   - Style guide: `docs/.rules`
19   - Agent guidelines: `docs/AGENTS.md`
20   - Formatting: Prettier (config in `docs/.prettierrc`)
21
223. **Identify Build and Tooling**
23   - Note build systems (cargo, npm, etc.)
24   - Identify documentation tooling (mdbook, etc.)
25
264. **Output Format**
27Produce a JSON summary:
28
29```json
30{
31  "primary_language": "Rust",
32  "frameworks": ["GPUI"],
33  "documentation": {
34    "system": "mdBook",
35    "location": "docs/src/",
36    "toc_file": "docs/src/SUMMARY.md",
37    "toc_format": "https://rust-lang.github.io/mdBook/format/summary.html",
38    "style_guide": "docs/.rules",
39    "agent_guidelines": "docs/AGENTS.md",
40    "formatter": "prettier",
41    "formatter_config": "docs/.prettierrc",
42    "custom_preprocessor": "docs_preprocessor (handles {#kb action::Name} syntax)"
43  },
44  "key_directories": {
45    "source": "crates/",
46    "docs": "docs/src/",
47    "extensions": "extensions/"
48  }
49}
50```
51
52## Constraints
53- Read-only: Do not modify any files
54- Focus on structure, not content details
55- Complete within 2 minutes