summary
like "all tests pass" without the output is a claim, not proof.
3. **Frontend / UI change → ALWAYS a screenshot.** If the change is visible in a UI,
capture
Second Brain — Architecture Notes
Local-first AI kernel with SQLite persistence, a REPL frontend, package
install/uninstall, and live plugin loading. Python / SQLite. Solo dev (Henry).
The Flet GUI was removed
working — whether by user verification, live agent testing, or manual QA — add regression tests (frontend and/or backend as appropriate) to prevent it from breaking later. The goal is to ratchet
Dashboard** (`dashboard/`): Self-contained Starlette app with a single `index.html` template (no frontend build step). SSE endpoint streams all domains in parallel via `asyncio.gather()`, refreshes every 30 seconds. Loads
check -p vestige-mcp` before
commits that touch dashboard HTTP routes or MCP tools — frontend gates do not
compile Rust.
For documentation-only changes, at minimum run:
```sh
git diff
backup various Claude Code configuration files across different locations (user, enterprise).
## Tech Stack
- **Frontend**: React 19 with TypeScript
- **Backend**: Rust with Tauri v2
- **Build Tool**: Vite with React plugin
- **Styling
leave stale published numbers after a detection-logic change. There are ZERO exceptions.
---
## 8) Frontend Rules (Jetpack Compose + Material Design 3)
### UI/UX baseline
- Build modern, stylish, cool, responsive UI using
container does not watch (`package.json`, container env), run `docker compose restart `.
- When doing frontend-only work in `packages/web`, use `pnpm start:web:mock`.
- When verifying a change, run `pnpm typecheck
when* to ship, read [`app_creation/AUTHORING.md`](coding/src/skills/app_creation/AUTHORING.md) — the iteration loop, product-design rules, frontend and icon guidelines, the recurring-run pattern, boundaries, validation, and the delivery checklist.
- When you need
point. IJFW orchestrates think-build-ship end to end and dispatches peer specialist skills (frontend-design, TDD, code-review) as subagent tools when the workflow needs them
docroot/modules/custom/xinshi_api/` plus deployment-specific deltas. The dev proxy target `base.builder.design` serves this codebase.
## Sibling Frontend Repository
- `../pro` — the pro deployment checkout of this frontend (branch `pro`). It merges `master
plus `cargo check --manifest-path src-tauri/Cargo.toml` if the change crosses module boundaries.
- Frontend changes: `npx tsc --noEmit` and any relevant Vitest suite. For visual changes, see Styling Rules
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
Where does it go?
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
What should it contain?
Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.
CLAUDE.md or AGENTS.md?
Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.