50 lines
2.2 KiB
Markdown
50 lines
2.2 KiB
Markdown
# Step 1 — Repo Analysis (Brownfield)
|
|
|
|
## Project: MiroFish
|
|
Multi-Agent Swarm Intelligence Prediction Engine.
|
|
|
|
## Date: 2026-05-06
|
|
|
|
## Findings
|
|
|
|
### Top-level Structure
|
|
```
|
|
MiroFish/
|
|
├── .claude/ # Claude Code config (Step 0 set up)
|
|
├── .codegraph/ # local index, gitignored
|
|
├── .github/workflows/ # CI
|
|
├── backend/ # Python (Flask, uv)
|
|
│ ├── app/{api,services,models,utils,config}
|
|
│ ├── pyproject.toml, requirements.txt, run.py, uv.lock
|
|
│ └── scripts/
|
|
├── frontend/ # Vue 3 + Vite
|
|
│ ├── src/{api,components,views,router,store,i18n,assets}
|
|
│ ├── package.json, vite.config.js, index.html
|
|
│ └── public/
|
|
├── locales/, static/
|
|
├── package.json # root orchestrator (concurrent dev)
|
|
├── docker-compose.yml, Dockerfile
|
|
├── README.md, README-EN.md, README-ZH.md
|
|
├── CLAUDE.md
|
|
└── LICENSE
|
|
```
|
|
|
|
### Decisions
|
|
|
|
| Question | Decision |
|
|
|----------|----------|
|
|
| Q1 — Structure changes? | **No changes**. Existing layout is intentional and aligns with the layer-based convention from the Salestech Dev Guidelines. |
|
|
| Q2 — Create `docs/`? | **No**. Documentation stays in `README*.md`, `CLAUDE.md`, and `.claude/onboarding/`. |
|
|
| Q3 — Keep `.claude/`? | **Yes, keep as-is** (configured during Step 0). |
|
|
| Q4 — `.gitignore` additions? | **No further changes**. Step 0 already updated `.gitignore` to track project-level `.claude/` and ignore `settings.local.json` and `.codegraph/`. |
|
|
| Q5 — Trilingual README? | **Keep** the three READMEs (`README.md` = English default, `README-EN.md` = explicit EN, `README-ZH.md` = Chinese). |
|
|
|
|
### Already Configured (from Step 0)
|
|
- `.claude/settings.json` — permissions (allow safe bash, deny secrets / destructive cmds)
|
|
- `.claude/rules/` — markdown, file-paths, commits, error-handling, dev-guidelines
|
|
- `.gitignore` — tracks project-level `.claude/`, ignores `settings.local.json` + `.codegraph/`
|
|
|
|
## Next
|
|
- **PROMPT 2:** Review / update `CLAUDE.md` (tech stack, conventions, architecture, commands).
|
|
- **PROMPT 3:** Review / update `README.md` (prerequisites, env vars, install).
|