the-frame-ai 0.7.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "the-frame-ai",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "FRAME — Framework for AI-Assisted Solo Development",
   "type": "module",
   "bin": {

package/templates/commands/frame:arch.md

@@ -0,0 +1,113 @@
+# /frame:arch — Module Architecture
+
+Analyse a module and generate `docs/arch/{module}.md` with its architecture description.
+
+## Instructions
+
+### Step 0: Fail-fast
+
+Require a module name or path. If missing, STOP: "Which module? Provide a module name or path (e.g. `/frame:arch chat` or `/frame:arch src/payments`)."
+
+### Step 1: Locate the module
+
+Find relevant files:
+```bash
+find . -type f \( -name "*.ts" -o -name "*.js" -o -name "*.py" -o -name "*.go" \) \
+  | grep -i "{module}" | grep -v node_modules | grep -v dist | head -30
+```
+
+If nothing found, try broader search:
+```bash
+grep -rn "{module}" . --include="*.ts" --include="*.js" --include="*.py" --include="*.go" \
+  -l | grep -v node_modules | grep -v dist | head -20
+```
+
+If still nothing: STOP — "Module '{module}' not found. Check the name and try again."
+
+### Step 2: Read the files
+
+Read all located files fully. For large files (>200 lines), focus on:
+- Exports / public API
+- Main classes, functions, types
+- Imports (what this module depends on)
+
+### Step 3: Find entry points and dependencies
+
+```bash
+grep -rn "import.*{module}\|require.*{module}\|from.*{module}" . \
+  --include="*.ts" --include="*.js" --include="*.py" --include="*.go" \
+  | grep -v node_modules | grep -v dist | head -20
+```
+
+This shows who depends on this module.
+
+### Step 4: Check existing doc
+
+```bash
+cat docs/arch/{module}.md 2>/dev/null
+```
+
+If it exists, note what has changed since it was written.
+
+### Step 5: Generate the document
+
+Create or overwrite `docs/arch/{module}.md`:
+
+```markdown
+# {Module} — Architecture
+
+> Generated: {date}
+
+## Overview
+
+{2-3 sentences: what this module does and why it exists}
+
+## Responsibilities
+
+- {responsibility 1}
+- {responsibility 2}
+- ...
+
+## File Structure
+
+| File | Role |
+|------|------|
+| {file} | {what it does} |
+
+## Public API
+
+{Key exports, functions, classes with one-line descriptions}
+
+## Dependencies
+
+**Depends on:**
+- {internal module or external package} — {why}
+
+**Used by:**
+- {module or file} — {how}
+
+## Data Flow
+
+{Describe how data enters, transforms, and exits this module. Use plain text or a simple ASCII diagram.}
+
+## Key Decisions
+
+{Non-obvious design choices, constraints, or trade-offs. If none — omit this section.}
+```
+
+Write the file:
+```bash
+mkdir -p docs/arch
+```
+Then write `docs/arch/{module}.md` with the generated content.
+
+### Step 6: Confirm
+
+Report: "Architecture documented → `docs/arch/{module}.md`" and list the files analysed.
+
+## Rules
+
+- Overwrite if file already exists — always reflect current state
+- No code changes, only the doc file
+- Keep the doc factual — describe what exists, not what should exist
+- If the module spans many files, summarise patterns rather than listing every detail

package/templates/project/CLAUDE.md

@@ -1,64 +0,0 @@
-# CLAUDE.md — {{PROJECT_NAME}}
-
-## Tech Stack
-
-(to be filled after /frame:init scan)
-
-## Architecture
-
-(to be filled after /frame:init scan)
-
-## Key Patterns
-
-(to be filled after /frame:init scan)
-
-## Code Conventions
-
-- **File naming**: (define your convention)
-- **Imports**: (define your import order)
-- **TypeScript**: Strict mode
-- **Git**: `{type}({scope}): {description}` — types: feat, fix, refactor, test, docs, chore
-- **Tests**: co-located or `__tests__/` directory
-
-## Rules (MUST follow)
-
-1. Always run quality checks before commit
-2. Use error reporting (not console.log)
-3. No `any` type — use `unknown` + type guard
-4. New features require tests
-
-## FRAME Framework
-
-This project uses FRAME (Framework for AI-Assisted Solo Development).
-
-**Commands**:
-- `/frame:init` — initialize project
-- `/frame:status` — current state
-- `/frame:fast <task>` — quick task
-- `/frame:research <topic>` — domain research
-- `/frame:plan <feature>` — plan feature
-- `/frame:build` — implement with TDD
-- `/frame:review` — code review
-- `/frame:security` — security audit (secrets, OWASP, infra, AI)
-- `/frame:ship` — git + PR
-- `/frame:debug <issue>` — systematic debugging
-- `/frame:retrospective` — retrospective + memory update
-- `/frame:cleanup-memory` — trim and archive memory files
-
-**Key files**:
-- `.planning/STATE.md` — current position
-- `.planning/MAP.md` — project map
-- `.planning/ROADMAP.md` — roadmap
-- `.frame/config.json` — FRAME configuration
-- `.planning/memory/` — project memory
-
-**Quality Gates** (D→P→D):
-- `{quality.commands.typecheck}` — Type check
-- `{quality.commands.test}` — Test check
-- `{quality.commands.lint}` — Lint check
-- `{quality.commands.build}` — Build check (before Ship)
-
-## Anti-Patterns (NEVER do)
-
-- ❌ Skip verification steps (D→P→D is mandatory)
-- ❌ `any` type (use `unknown` + type guard)