@mind-fold/open-flow 0.1.17 → 0.2.2

package/dist/templates/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,iCAAiC,GAAG,WAAW,CAC3D,iCAAiC,CACjC,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAG,WAAW,CAC1D,gCAAgC,CAChC,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC,yBAAyB,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC,wBAAwB,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,+BAA+B,GAAG,WAAW,CACzD,+BAA+B,CAC/B,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAG,WAAW,CACxD,8BAA8B,CAC9B,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,yBAAyB;AACzB,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAE7E,6BAA6B;AAC7B,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAE5E,2BAA2B;AAC3B,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC,yBAAyB,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC,wBAAwB,CAAC,CAAC;AAE9E,gCAAgC;AAChC,MAAM,CAAC,MAAM,iCAAiC,GAAG,WAAW,CAC3D,iCAAiC,CACjC,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAG,WAAW,CAC1D,gCAAgC,CAChC,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAG,WAAW,CACzD,+BAA+B,CAC/B,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAG,WAAW,CACxD,8BAA8B,CAC9B,CAAC;AAEF,2BAA2B;AAC3B,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAE/D,mBAAmB;AACnB,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;AAEzE,0BAA0B;AAC1B,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC"}

package/dist/templates/commands/init-agent.txt

@@ -1,11 +1,102 @@
-Read the project root's init-agent.md file and follow the instructions to initialize the AI session.
+# Initialize AI Agent Session
 
-Execute these steps:
-1. Get full session context (one command):
-   ```bash
-   ./workflow/scripts/get-context.sh
-   ```
-2. If not initialized, guide the user to run: `./workflow/scripts/init-developer.sh <name>`
-3. Read relevant structure guidelines based on the task
-4. Report ready status and ask for the task
+Read project context and prepare for development work.
 
+---
+
+## Execution Steps
+
+### Step 1: Get Session Context
+
+```bash
+./workflow/scripts/get-context.sh
+```
+
+This returns:
+- Developer identity
+- Git status (branch, uncommitted changes)
+- Recent commits
+- Active features
+- Progress file status
+
+### Step 2: Check Developer Identity
+
+If `.developer` file doesn't exist, guide user:
+
+```bash
+./workflow/scripts/init-developer.sh <name>
+```
+
+### Step 3: Read Relevant Guidelines
+
+Based on the upcoming task, read appropriate structure docs:
+
+**For Frontend Work**:
+```bash
+cat workflow/structure/frontend/index.md
+```
+Then read specific docs based on task type.
+
+**For Backend Work**:
+```bash
+cat workflow/structure/backend/index.md
+```
+Then read specific docs based on task type.
+
+**For Cross-Layer Features**:
+```bash
+cat workflow/structure/flows/index.md
+cat workflow/structure/flows/cross-layer-thinking-guide.md
+```
+
+### Step 4: Check Active Features
+
+```bash
+./workflow/scripts/feature.sh list
+```
+
+If continuing previous work, review the feature file.
+
+### Step 5: Report Ready Status
+
+Output a summary:
+
+```markdown
+## Session Initialized
+
+| Item | Status |
+|------|--------|
+| Developer | {name} |
+| Branch | {branch} |
+| Uncommitted | {count} file(s) |
+| Progress | {file} ({lines}/2000 lines) |
+| Active Features | {count} |
+
+### Available Commands
+- `/before-frontend-dev` - Read frontend guidelines
+- `/before-backend-dev` - Read backend guidelines
+- `/check-cross-layer` - Cross-layer verification
+- `/finish-work` - Pre-commit checklist
+- `/record-agent-flow` - Record session progress
+
+Ready for your task. What would you like to work on?
+```
+
+---
+
+## Quick Reference
+
+| Scenario | Next Step |
+|----------|-----------|
+| New feature | `./workflow/scripts/feature.sh create <name>` |
+| Continue feature | Read feature file, continue work |
+| Bug fix | Investigate, fix, then `/break-loop` |
+| First time | `/onboard-developer` for full setup |
+
+---
+
+## Notes
+
+- Always read structure guidelines before coding
+- One feature at a time
+- Record progress at session end with `/record-agent-flow`

package/dist/templates/commands/sync-from-runtime.txt

@@ -0,0 +1,140 @@
+# Sync Knowledge from Runtime
+
+Fetch and adapt knowledge documents from Runtime to enhance local workflow structure.
+
+---
+
+## Prerequisites
+
+- Runtime MCP server connected (`mcp__runtime-cloud__*` tools available)
+- Local `workflow/structure/` directory exists
+
+---
+
+## Execution Steps
+
+### Step 1: Get User Input
+
+Ask the user:
+
+1. **Source path on Runtime**: Where to fetch docs from?
+   - Example: `/dev/cloudflare worker/backend/`
+   - Example: `/dev/electron/frontend/`
+
+2. **Target location**: Where to save locally?
+   - `workflow/structure/backend/` (backend docs)
+   - `workflow/structure/frontend/` (frontend docs)
+   - `workflow/structure/flows/` (cross-layer docs)
+
+3. **Sync mode**:
+   - `merge` - Add new docs, keep existing (default)
+   - `replace` - Replace all docs in target directory
+
+### Step 2: List Available Docs
+
+```bash
+# List docs at source path
+mcp__runtime-cloud__ls <source-path>
+```
+
+Show user what's available and let them confirm which docs to sync.
+
+### Step 3: Fetch and Adapt
+
+For each selected doc:
+
+1. **Read from Runtime**:
+   ```bash
+   mcp__runtime-cloud__cat <source-path>/<doc-name>
+   ```
+
+2. **Adapt content** (if needed):
+   - Replace project-specific paths with generic placeholders
+   - Remove project-specific examples if too specific
+   - Keep the core patterns and guidelines
+
+3. **Write to local**:
+   - Save to `workflow/structure/<target>/<doc-name>`
+
+### Step 4: Update Index
+
+After syncing, update `workflow/structure/<target>/index.md`:
+- Add links to new docs
+- Update the quick navigation table
+
+---
+
+## Example Usage
+
+**User**: "Sync backend database guidelines from Runtime"
+
+**AI executes**:
+```
+1. Ask: "What's the source path on Runtime?"
+   User: "/dev/cloudflare worker/backend/"
+
+2. List available docs:
+   - database-guidelines.md
+   - logging-guidelines.md
+   - ...
+
+3. Ask: "Which docs to sync? (all / specific names)"
+   User: "database-guidelines.md"
+
+4. Fetch, adapt, save to workflow/structure/backend/
+
+5. Update workflow/structure/backend/index.md
+```
+
+---
+
+## Adaptation Guidelines
+
+When adapting Runtime docs to local:
+
+| Runtime-Specific | Replace With |
+|------------------|--------------|
+| Turso/libSQL specific | Generic SQLite/ORM |
+| Cloudflare Workers specific | Generic serverless |
+| Project-specific paths | `{your-path}` placeholders |
+| Internal team references | Remove or generalize |
+
+**Keep**:
+- Core patterns (no await in loops, batch operations, etc.)
+- Type safety guidelines
+- Error handling patterns
+- Logging best practices
+
+---
+
+## Output
+
+After sync, report:
+
+```markdown
+## Sync Complete
+
+**Source**: /dev/cloudflare worker/backend/
+**Target**: workflow/structure/backend/
+
+### Synced Docs
+| Doc | Status | Notes |
+|-----|--------|-------|
+| database-guidelines.md | ✅ Added | Adapted from Turso to generic ORM |
+| logging-guidelines.md | ✅ Added | No changes needed |
+
+### Updated Files
+- workflow/structure/backend/index.md (added links)
+
+### Next Steps
+- Review synced docs for project-specific adjustments
+- Run `/check-backend` to verify guidelines work
+```
+
+---
+
+## Notes
+
+- Always review synced docs before committing
+- Some Runtime docs may need significant adaptation
+- Keep local customizations in separate sections (won't be overwritten on re-sync)

package/dist/templates/markdown/flow.md.txt

@@ -20,7 +20,7 @@
 ### Core Principles
 
 1. **Read Before Write** - Understand context before starting
-2. **Follow Standards** - ⚠️ **MUST read `workflow/structure/` guidelines (index → doc) before coding**
+2. **Follow Standards** - ⚠️ **MUST read `workflow/structure/` guidelines before coding**
 3. **Incremental Development** - Complete one feature at a time
 4. **Record Promptly** - Update tracking files immediately after completion
 5. **Document Limits** - ⚠️ **Max 2000 lines per agent-progress document**
@@ -44,12 +44,26 @@ workflow/
 │       ├── features/    # Feature tracking
 │       └── progress-N.md  # Progress files (sequential numbering)
 ├── structure/           # ⚠️ MUST READ before coding
-│   ├── frontend/
-│   │   ├── index.md    # Frontend guidelines index (read first)
-│   │   └── doc.md      # Frontend guidelines detailed doc (read specific sections)
-│   └── backend/
-│       ├── index.md    # Backend guidelines index (read first)
-│       └── doc.md      # Backend guidelines detailed doc (read specific sections)
+│   ├── frontend/        # Frontend guidelines (multi-doc)
+│   │   ├── index.md               # Start here - guidelines index
+│   │   ├── directory-structure.md # Directory layout
+│   │   ├── type-safety.md         # TypeScript patterns
+│   │   ├── hook-guidelines.md     # React Query hooks
+│   │   ├── component-guidelines.md # Component patterns
+│   │   ├── state-management.md    # State patterns
+│   │   └── quality-guidelines.md  # Code standards
+│   ├── backend/         # Backend guidelines (multi-doc)
+│   │   ├── index.md               # Start here - guidelines index
+│   │   ├── directory-structure.md # Directory layout
+│   │   ├── type-safety.md         # Zod, TypeScript patterns
+│   │   ├── database-guidelines.md # ORM, batch operations
+│   │   ├── logging-guidelines.md  # Structured logging
+│   │   ├── error-handling.md      # Error types, handling
+│   │   └── quality-guidelines.md  # Code standards
+│   └── flows/           # Cross-layer specifications
+│       ├── index.md                      # Flow specs index
+│       ├── cross-layer-thinking-guide.md # Pre-implementation checklist
+│       └── spec-flow-template.md         # Template for new flows
 └── flow.md             # This document
 ```
 
@@ -69,51 +83,41 @@ Use the unified context script:
 ./workflow/scripts/get-context.sh --json
 ```
 
-### Step 2: Read Development Guidelines Index ⚠️ REQUIRED
+### Step 2: Read Development Guidelines ⚠️ REQUIRED
 
 **⚠️ CRITICAL: MUST read guidelines before writing any code**
 
-Based on what you'll develop (frontend/backend), read the corresponding guidelines **index document**:
+Based on what you'll develop (frontend/backend), read the corresponding guidelines:
 
 **Frontend Development**:
 ```bash
+# 1. Read index first
 cat workflow/structure/frontend/index.md
+
+# 2. Read specific doc based on task
+cat workflow/structure/frontend/hook-guidelines.md      # For hooks
+cat workflow/structure/frontend/component-guidelines.md # For components
+cat workflow/structure/frontend/type-safety.md          # For types
 ```
-- Find corresponding chapters based on task type (e.g., "New Query Hook", "Write Component")
-- Note down chapter names and **section IDs** (e.g., `query-hook`)
-- This is **mandatory**, not optional
 
 **Backend Development**:
 ```bash
+# 1. Read index first
 cat workflow/structure/backend/index.md
-```
-- Find corresponding chapters based on scenario (e.g., "New API Module", "Write Batch Tasks")
-- Note down chapter names and **section IDs** (e.g., `database-guidelines`)
-- This is **mandatory**, not optional
-
-### Step 3: Read Specific Guidelines ⚠️ REQUIRED
-
-**⚠️ CRITICAL: Read detailed guidelines for your specific task**
 
-Based on section IDs found in index, extract specific sections:
-
-**Frontend**:
-```bash
-# Extract specific section by ID
-sed -n '/@@@section:query-hook/,/@@@\/section:query-hook/p' workflow/structure/frontend/doc.md
+# 2. Read specific doc based on task
+cat workflow/structure/backend/database-guidelines.md   # For DB operations
+cat workflow/structure/backend/type-safety.md           # For Zod/types
+cat workflow/structure/backend/logging-guidelines.md    # For logging
 ```
-- **MUST read** the sections relevant to your task
-- Do NOT skip this step
 
-**Backend**:
+**Cross-Layer Features**:
 ```bash
-# Extract specific section by ID
-sed -n '/@@@section:database-guidelines/,/@@@\/section:database-guidelines/p' workflow/structure/backend/doc.md
+# For features spanning multiple layers
+cat workflow/structure/flows/cross-layer-thinking-guide.md
 ```
-- **MUST read** the sections relevant to your task
-- Do NOT skip this step
 
-### Step 4: Select Feature to Develop
+### Step 3: Select Feature to Develop
 
 Use the feature management script:
 
@@ -136,9 +140,10 @@ Use the feature management script:
    └─> ./workflow/scripts/feature.sh create <name> or list
 
 2. Write code according to guidelines
-   └─> Strictly follow workflow/structure/ development guidelines
-   └─> Frontend: Type safety, Hook standards, Component standards, Performance
-   └─> Backend: Directory structure, Type safety, Database operations, Logging
+   └─> Read workflow/structure/[frontend|backend]/ docs
+   └─> For cross-layer: read workflow/structure/flows/
+   └─> Frontend: Type safety, Hook standards, Component standards
+   └─> Backend: Directory structure, Type safety, Database, Logging
 
 3. Self-test
    └─> pnpm lint (must pass)
@@ -161,18 +166,17 @@ Use the feature management script:
 - ✅ `pnpm type-check` - No type errors
 - ✅ Manual feature testing passes
 
-**Frontend-specific checks**:
+**Frontend-specific checks** (see `frontend/quality-guidelines.md`):
 - ✅ Use semantic HTML (`<button>` not `<div role="button">`)
 - ✅ Use Next.js `<Image>` instead of `<img>`
 - ✅ Import types from backend, don't redefine
 - ✅ Avoid non-null assertions `!`
 
-**Backend-specific checks**:
-- ✅ Strictly avoid non-null assertion `!`, use local variable extraction
+**Backend-specific checks** (see `backend/quality-guidelines.md`):
+- ✅ Strictly avoid non-null assertion `!`
 - ✅ All API inputs/outputs have Zod Schema
 - ✅ Use structured logging (`logger`), forbidden `console.log`
 - ✅ Database operations avoid `await` in loops
-- ✅ Update corresponding API documentation
 
 ---
 
@@ -197,10 +201,12 @@ This automatically:
 
 ### Pre-end Checklist
 
+Use `/finish-work` command to run through:
 1. ✅ All code committed, commit message follows convention
 2. ✅ Session recorded via `add-session.sh`
 3. ✅ No lint/type-check errors
 4. ✅ Working directory clean (or WIP noted)
+5. ✅ Structure docs updated if needed
 
 ---
 
@@ -225,24 +231,36 @@ agent-progress/
 - ✅ Complete important feature
 - ✅ Fix important bug
 
-**How to update**:
-Use the `add-session.sh` script for automatic updates.
+### 2. structure/ - Development Guidelines
 
-### 2. Features - Feature Tracking
+**Purpose**: Documented standards for consistent development
 
-**Purpose**: Track feature status per developer
+**Structure** (Multi-doc format):
+```
+structure/
+├── frontend/           # Frontend docs
+│   ├── index.md        # Start here
+│   └── *.md            # Topic-specific docs
+├── backend/            # Backend docs
+│   ├── index.md        # Start here
+│   └── *.md            # Topic-specific docs
+└── flows/              # Cross-layer specs
+    ├── index.md        # Start here
+    └── *.md            # Flow-specific docs
+```
+
+**When to update**:
+- ✅ New pattern discovered
+- ✅ Bug fixed that reveals missing guidance
+- ✅ New convention established
+
+### 3. Features - Feature Tracking
 
 **Commands**:
 ```bash
-# Create new feature
 ./workflow/scripts/feature.sh create <name>
-
-# Archive completed feature
 ./workflow/scripts/feature.sh archive <name>
-
-# List features
 ./workflow/scripts/feature.sh list
-./workflow/scripts/feature.sh list-archive [YYYY-MM]
 ```
 
 ---
@@ -253,31 +271,29 @@ Use the `add-session.sh` script for automatic updates.
 
 1. **Before session start**:
    - Run `./workflow/scripts/get-context.sh` for full context
-   - ⚠️ **MUST read** `workflow/structure/[frontend|backend]/index.md`
-   - ⚠️ **MUST read** specific sections in doc.md based on task
+   - ⚠️ **MUST read** relevant `workflow/structure/` docs
 
 2. **During development**:
-   - ⚠️ **Strictly follow** `workflow/structure/` frontend/backend guidelines
+   - ⚠️ **Follow** `workflow/structure/` guidelines
+   - For cross-layer features, use `/check-cross-layer`
    - Develop only one feature at a time
-   - Run lint and type-check before finishing
+   - Run lint and type-check frequently
 
-3. **After development complete** (⚠️ AI should not commit, human is responsible):
-   - AI reminds human to test
+3. **After development complete**:
+   - Use `/finish-work` for completion checklist
+   - After fix bug, use `/break-loop` for deep analysis
    - Human commits after testing passes
-   - After human commits, use `add-session.sh` to record progress
+   - Use `add-session.sh` to record progress
 
 ### ❌ DON'T - Should Not Do
 
-1. ⚠️ **Don't** skip reading `workflow/structure/` guidelines (CRITICAL VIOLATION)
+1. ⚠️ **Don't** skip reading `workflow/structure/` guidelines
 2. ⚠️ **Don't** let agent-progress single file exceed 2000 lines
-3. **Don't** skip reading context files
-4. **Don't** develop multiple unrelated features simultaneously
-5. **Don't** commit code with lint/type-check errors
-6. **Don't** forget to update tracking files
-7. ⚠️ **Don't** execute `git commit` - AI should not commit code
-   - Only allowed: `git log`, `git status`, `git diff`
-   - Human is responsible for testing and committing
-8. **Don't** write `workflow/structure/` docs in Chinese - **English only**
+3. **Don't** develop multiple unrelated features simultaneously
+4. **Don't** commit code with lint/type-check errors
+5. **Don't** forget to update structure docs after learning something
+6. ⚠️ **Don't** execute `git commit` - AI should not commit code
+7. **Don't** write `workflow/structure/` docs in Chinese - **English only**
 
 ---
 
@@ -285,13 +301,13 @@ Use the `add-session.sh` script for automatic updates.
 
 ### Must-read Before Development
 
-| Task Type | Must-read Document | Section ID |
-|---------|---------|------|
-| New Frontend Query Hook | `frontend/doc.md` | `query-hook` |
-| New Frontend Mutation Hook | `frontend/doc.md` | `mutation-hook` |
-| New Frontend Component | `frontend/doc.md` | `component-guidelines` |
-| New Backend API | `backend/doc.md` | `directory-structure`, `type-safety` |
-| Database Batch Operations | `backend/doc.md` | `database-guidelines` |
+| Task Type | Must-read Document |
+|-----------|-------------------|
+| New Query Hook | `frontend/hook-guidelines.md` |
+| New Component | `frontend/component-guidelines.md` |
+| New Backend API | `backend/directory-structure.md`, `backend/type-safety.md` |
+| Database Operations | `backend/database-guidelines.md` |
+| Cross-Layer Feature | `flows/cross-layer-thinking-guide.md` |
 
 ### Commit Convention
 
@@ -301,7 +317,6 @@ git commit -m "type(scope): description"
 
 **Type**: feat, fix, docs, refactor, test, chore
 **Scope**: Module name (e.g., mail, auth, api)
-**Description**: Brief description
 
 ### Common Commands
 
@@ -316,15 +331,13 @@ git commit -m "type(scope): description"
 
 # Development
 pnpm dev              # Start dev server
-pnpm build            # Production build
 pnpm lint             # Lint check
-pnpm format           # Format code
 pnpm type-check       # Type check
 
-# Git
-git log --oneline -20         # Recent 20 commits
-git diff main...HEAD          # Diff with main
-git status                    # Working directory status
+# Slash commands
+/finish-work          # Pre-commit checklist
+/break-loop           # Post-debug analysis
+/check-cross-layer    # Cross-layer verification
 ```
 
 ---
@@ -335,8 +348,7 @@ Following this workflow ensures:
 - ✅ Continuity across multiple sessions
 - ✅ Consistent code quality
 - ✅ Trackable progress
-- ✅ Easy recovery and rollback
+- ✅ Knowledge accumulation in structure docs
 - ✅ Transparent team collaboration
 
-**Core Philosophy**: Read before write, follow standards, record promptly, develop incrementally
-
+**Core Philosophy**: Read before write, follow standards, record promptly, capture learnings

package/dist/templates/markdown/index.d.ts

@@ -3,10 +3,27 @@
  * Each template is stored as a .txt file
  */
 export declare const agentProgressIndexContent: string;
-export declare const frontendIndexContent: string;
-export declare const frontendDocContent: string;
-export declare const backendIndexContent: string;
-export declare const backendDocContent: string;
 export declare const flowMdContent: string;
 export declare const workflowGitignoreContent: string;
+export declare const backendIndexContent: string;
+export declare const backendDirectoryStructureContent: string;
+export declare const backendTypeSafetyContent: string;
+export declare const backendDatabaseGuidelinesContent: string;
+export declare const backendLoggingGuidelinesContent: string;
+export declare const backendQualityGuidelinesContent: string;
+export declare const backendErrorHandlingContent: string;
+export declare const frontendIndexContent: string;
+export declare const frontendDirectoryStructureContent: string;
+export declare const frontendTypeSafetyContent: string;
+export declare const frontendHookGuidelinesContent: string;
+export declare const frontendComponentGuidelinesContent: string;
+export declare const frontendQualityGuidelinesContent: string;
+export declare const frontendStateManagementContent: string;
+export declare const flowsIndexContent: string;
+export declare const flowsCrossLayerThinkingGuideContent: string;
+export declare const flowsSpecFlowTemplateContent: string;
+export declare const flowsPreImplementationChecklistContent: string;
+export declare const flowsCodeReuseThinkingGuideContent: string;
+export declare const backendDocContent: string;
+export declare const frontendDocContent: string;
 //# sourceMappingURL=index.d.ts.map

package/dist/templates/markdown/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,yBAAyB,QAErC,CAAC;AACF,eAAO,MAAM,oBAAoB,QAAwC,CAAC;AAC1E,eAAO,MAAM,kBAAkB,QAAsC,CAAC;AACtE,eAAO,MAAM,mBAAmB,QAAuC,CAAC;AACxE,eAAO,MAAM,iBAAiB,QAAqC,CAAC;AACpE,eAAO,MAAM,aAAa,QAA8B,CAAC;AACzD,eAAO,MAAM,wBAAwB,QAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,eAAO,MAAM,yBAAyB,QAErC,CAAC;AAGF,eAAO,MAAM,aAAa,QAA8B,CAAC;AACzD,eAAO,MAAM,wBAAwB,QAAgC,CAAC;AAGtE,eAAO,MAAM,mBAAmB,QAE/B,CAAC;AACF,eAAO,MAAM,gCAAgC,QAE5C,CAAC;AACF,eAAO,MAAM,wBAAwB,QAEpC,CAAC;AACF,eAAO,MAAM,gCAAgC,QAE5C,CAAC;AACF,eAAO,MAAM,+BAA+B,QAE3C,CAAC;AACF,eAAO,MAAM,+BAA+B,QAE3C,CAAC;AACF,eAAO,MAAM,2BAA2B,QAEvC,CAAC;AAGF,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AACF,eAAO,MAAM,iCAAiC,QAE7C,CAAC;AACF,eAAO,MAAM,yBAAyB,QAErC,CAAC;AACF,eAAO,MAAM,6BAA6B,QAEzC,CAAC;AACF,eAAO,MAAM,kCAAkC,QAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,QAE5C,CAAC;AACF,eAAO,MAAM,8BAA8B,QAE1C,CAAC;AAGF,eAAO,MAAM,iBAAiB,QAA+C,CAAC;AAC9E,eAAO,MAAM,mCAAmC,QAE/C,CAAC;AACF,eAAO,MAAM,4BAA4B,QAExC,CAAC;AACF,eAAO,MAAM,sCAAsC,QAElD,CAAC;AACF,eAAO,MAAM,kCAAkC,QAE9C,CAAC;AAGF,eAAO,MAAM,iBAAiB,QAAqC,CAAC;AACpE,eAAO,MAAM,kBAAkB,QAAsC,CAAC"}

package/dist/templates/markdown/index.js

@@ -3,11 +3,34 @@
  * Each template is stored as a .txt file
  */
 import { readMarkdown } from "../extract.js";
+// Agent progress
 export const agentProgressIndexContent = readMarkdown("agent-progress-index.md.txt");
-export const frontendIndexContent = readMarkdown("frontend-index.md.txt");
-export const frontendDocContent = readMarkdown("frontend-doc.md.txt");
-export const backendIndexContent = readMarkdown("backend-index.md.txt");
-export const backendDocContent = readMarkdown("backend-doc.md.txt");
+// Flow documentation
 export const flowMdContent = readMarkdown("flow.md.txt");
 export const workflowGitignoreContent = readMarkdown("gitignore.txt");
+// Backend structure (multi-doc format)
+export const backendIndexContent = readMarkdown("structure/backend/index.md.txt");
+export const backendDirectoryStructureContent = readMarkdown("structure/backend/directory-structure.md.txt");
+export const backendTypeSafetyContent = readMarkdown("structure/backend/type-safety.md.txt");
+export const backendDatabaseGuidelinesContent = readMarkdown("structure/backend/database-guidelines.md.txt");
+export const backendLoggingGuidelinesContent = readMarkdown("structure/backend/logging-guidelines.md.txt");
+export const backendQualityGuidelinesContent = readMarkdown("structure/backend/quality-guidelines.md.txt");
+export const backendErrorHandlingContent = readMarkdown("structure/backend/error-handling.md.txt");
+// Frontend structure (multi-doc format)
+export const frontendIndexContent = readMarkdown("structure/frontend/index.md.txt");
+export const frontendDirectoryStructureContent = readMarkdown("structure/frontend/directory-structure.md.txt");
+export const frontendTypeSafetyContent = readMarkdown("structure/frontend/type-safety.md.txt");
+export const frontendHookGuidelinesContent = readMarkdown("structure/frontend/hook-guidelines.md.txt");
+export const frontendComponentGuidelinesContent = readMarkdown("structure/frontend/component-guidelines.md.txt");
+export const frontendQualityGuidelinesContent = readMarkdown("structure/frontend/quality-guidelines.md.txt");
+export const frontendStateManagementContent = readMarkdown("structure/frontend/state-management.md.txt");
+// Flows structure
+export const flowsIndexContent = readMarkdown("structure/flows/index.md.txt");
+export const flowsCrossLayerThinkingGuideContent = readMarkdown("structure/flows/cross-layer-thinking-guide.md.txt");
+export const flowsSpecFlowTemplateContent = readMarkdown("structure/flows/spec-flow-template.md.txt");
+export const flowsPreImplementationChecklistContent = readMarkdown("structure/flows/pre-implementation-checklist.md.txt");
+export const flowsCodeReuseThinkingGuideContent = readMarkdown("structure/flows/code-reuse-thinking-guide.md.txt");
+// Legacy single-doc format (kept for backward compatibility)
+export const backendDocContent = readMarkdown("backend-doc.md.txt");
+export const frontendDocContent = readMarkdown("frontend-doc.md.txt");
 //# sourceMappingURL=index.js.map

package/dist/templates/markdown/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CACpD,6BAA6B,CAC7B,CAAC;AACF,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC,sBAAsB,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,iBAAiB;AACjB,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CACpD,6BAA6B,CAC7B,CAAC;AAEF,qBAAqB;AACrB,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAEtE,uCAAuC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAC9C,gCAAgC,CAChC,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAG,YAAY,CAC3D,8CAA8C,CAC9C,CAAC;AACF,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CACnD,sCAAsC,CACtC,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAG,YAAY,CAC3D,8CAA8C,CAC9C,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAG,YAAY,CAC1D,6CAA6C,CAC7C,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAG,YAAY,CAC1D,6CAA6C,CAC7C,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAG,YAAY,CACtD,yCAAyC,CACzC,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAC/C,iCAAiC,CACjC,CAAC;AACF,MAAM,CAAC,MAAM,iCAAiC,GAAG,YAAY,CAC5D,+CAA+C,CAC/C,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CACpD,uCAAuC,CACvC,CAAC;AACF,MAAM,CAAC,MAAM,6BAA6B,GAAG,YAAY,CACxD,2CAA2C,CAC3C,CAAC;AACF,MAAM,CAAC,MAAM,kCAAkC,GAAG,YAAY,CAC7D,gDAAgD,CAChD,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAG,YAAY,CAC3D,8CAA8C,CAC9C,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAG,YAAY,CACzD,4CAA4C,CAC5C,CAAC;AAEF,kBAAkB;AAClB,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC,8BAA8B,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,mCAAmC,GAAG,YAAY,CAC9D,mDAAmD,CACnD,CAAC;AACF,MAAM,CAAC,MAAM,4BAA4B,GAAG,YAAY,CACvD,2CAA2C,CAC3C,CAAC;AACF,MAAM,CAAC,MAAM,sCAAsC,GAAG,YAAY,CACjE,qDAAqD,CACrD,CAAC;AACF,MAAM,CAAC,MAAM,kCAAkC,GAAG,YAAY,CAC7D,kDAAkD,CAClD,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC"}