docs: dedupe structure and stack descriptions (finding 32)

Why: AGENTS.md's Structure bullet restated apm-install mechanics already owned by
docs/spec/architecture.md:24 and README.md:55, and docs/VISION.md carried stack, framework and
deployment choices for a product that lives in a separate repo.

Implementation notes: AGENTS.md keeps two actionable one-liners plus pointers to the README
layout table and architecture.md, preserving the session rule that .claude/skills/ and
.claude/agents/ are install output and must not be edited. VISION.md's Phase 1 Architecture
block becomes a one-line scope statement; the "Mobile/desktop (Phase 3)" line is dropped as an
intra-file duplicate of the Phase 3 section.

Impact: no behaviour change. README.md and docs/spec/architecture.md are untouched -- the
finding's premise was inflated, and architecture.md had already been differentiated in a way it
documents in the file itself.

Refs: SIMPLIFICATION-AUDIT.md finding 32
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YR2CjVumUbEGWcMikcoXBD
This commit is contained in:
2026-09-14 20:31:40 +00:00
parent 062ca47a18
commit f91babcacd
2 changed files with 5 additions and 11 deletions

View File

@@ -48,18 +48,10 @@ Browse, edit, and configure AI development config through a proper product UI.
**Design principle:** This is a product, not a file browser. Users never see git operations, file paths, or commit messages. The UI presents domain concepts (skills, workflows, agents, providers) and handles persistence silently. Any feature that exposes git internals to the user is out of scope.
**Architecture:**
- Stack: React + TypeScript + Vite (frontend), Node.js + Fastify + TypeScript (backend), PostgreSQL (introduced only when a specific feature requires state with no natural home in git)
- Stack rationale: single language across the full stack keeps the codebase navigable for junior developers and AI coding agents; TypeScript's explicit types make intent clear without comments; React → React Native is the cleanest path to mobile in Phase 3; `simple-git` covers all required git operations without needing a Python backend
- Git operations via `simple-git`; git repo stays the source of truth
- Deployment: Docker (Nginx + Node containers), k8s-ready
- Hosting: self-hosted first, cloud-hosted option later
- Users: solo-first, multi-user-ready data model from day one
**Scope:** self-hosted first, cloud-hosted option later; solo-first, with a multi-user-ready data model from day one. The git repo stays the source of truth. Stack, framework and deployment choices belong to that product's own repo, not here.
**Start trigger:** when the plugin content model and sync tooling are stable. Full content model must be stable before building a UI over it.
**Mobile/desktop (Phase 3):** React → React Native for mobile; Tauri to wrap the web app for desktop.
### Phase 2 — Agent & Fleet Management
Runtime orchestration: push config updates to machines, see running agents, manage task queues and outputs across a fleet of machines and projects.