all-for-claudecode 2.0.0 → 2.2.0

package/templates/afc.config.template.md

@@ -1,90 +1,26 @@
-# AFC Configuration
+# Project Configuration
 
-> This file defines project-specific settings for the afc command system.
-> All afc commands reference this file to determine project-specific behavior.
-> Modify each section to match your project.
+> afc commands reference this file to determine project-specific behavior.
+> CI Commands are parsed by scripts — keep the YAML format intact.
+> All other sections are free-form markdown — write whatever best describes your project.
 
 ## CI Commands
 
+<!-- DO NOT change the format below. Scripts parse these keys. -->
 ```yaml
-ci: "npm run ci"                        # Full CI (lint + typecheck + build)
-typecheck: "npm run typecheck"          # Typecheck only
-lint: "npm run lint"                    # Lint only
-lint_fix: "npm run lint:fix"            # Auto-fix lint
-gate: "npm run typecheck && npm run lint"  # Phase gate (run repeatedly during implement)
-test: "npm test"                        # Tests
+ci: "npm run ci"
+gate: "npm run typecheck && npm run lint"
+test: "npm test"
 ```
 
 ## Architecture
 
-```yaml
-style: "Layered"                        # e.g.: FSD, Clean Architecture, Modular Monolith, Layered
-layers: []                              # List from top to bottom layer
-import_rule: ""                         # Import direction rule (e.g.: "upper → lower only")
-segments: []                            # Sub-segments for each layer
-path_alias: ""                          # e.g.: "@/* → ./src/*"
-```
-
-## Framework
-
-```yaml
-name: ""                                # e.g.: Next.js 14, Vite, CRA
-runtime: ""                             # e.g.: App Router, Pages Router
-client_directive: ""                    # e.g.: 'use client' (leave empty if not applicable)
-client_directive_rule: ""               # Rule for applying client directives
-server_client_boundary: false           # Whether a server/client boundary exists
-```
+(init analyzes your project and writes this section in free-form)
 
 ## Code Style
 
-```yaml
-language: "TypeScript"
-strict_mode: true
-type_keyword: "type"                    # type vs interface
-import_type: true                       # Whether to use import type
-component_style: "PascalCase"
-props_position: "above component"
-handler_naming: "handle[Event]"
-boolean_naming: "is/has/can[State]"
-constant_naming: "UPPER_SNAKE_CASE"
-any_policy: "minimize"
-```
-
-## State Management
-
-```yaml
-global_state: ""                        # e.g.: Zustand, Redux, Pinia
-server_state: ""                        # e.g.: React Query, SWR, Apollo
-local_state: ""                         # e.g.: Context API, useState
-store_location: ""                      # Store file location pattern
-query_location: ""                      # Query file location pattern
-```
-
-## Styling
-
-```yaml
-framework: ""                           # e.g.: Tailwind CSS, styled-components, CSS Modules
-```
-
-## Testing
-
-```yaml
-framework: ""                           # e.g.: Jest, Vitest, Playwright
-```
-
-## Project-Specific Risks
-
-> Project-specific risk patterns that must be checked in the Plan's RISK Critic
-> Modify to match your project.
-
-1. (example) Import order violation
-2. (example) Circular reference
-3. (example) Type safety bypass (as any)
-
-## Mini-Review Checklist
+(init analyzes your project and writes this section in free-form)
 
-> Items to inspect for each file in the Mini-Review of the Implement Phase gate
+## Project Context
 
-1. Architecture rule violations
-2. Code style pattern compliance
-3. Dead code (unused imports, empty exports, dead code)
+(init analyzes your project and writes this section in free-form — framework, state management, styling, testing, risks, etc.)

package/templates/afc.config.express-api.md

@@ -1,99 +0,0 @@
-# AFC Configuration
-
-> This file defines project-specific settings for the afc command system.
-> All afc commands reference this file to determine project-specific behavior.
-
-## CI Commands
-
-```yaml
-ci: "npm run build && npm run lint && npm run test"  # Full CI (build + lint + test)
-typecheck: "npx tsc --noEmit"                        # Typecheck only
-lint: "npx eslint src/"                              # Lint only
-lint_fix: "npx eslint src/ --fix"                    # Auto-fix lint
-gate: "npx tsc --noEmit && npx eslint src/"          # Phase gate (run repeatedly during implement)
-test: "npx jest --runInBand"                         # Tests
-```
-
-## Architecture
-
-```yaml
-style: "Layered"                        # Layered architecture
-layers:                                 # Top → bottom order
-  - src/routes
-  - src/controllers
-  - src/services
-  - src/repositories
-  - src/models
-  - src/middleware
-  - src/lib
-  - src/types
-  - src/config
-import_rule: "Upper layers (routes) depend only in order: controllers → services → repositories"
-segments: []
-path_alias: "@/* → ./src/*"
-```
-
-## Framework
-
-```yaml
-name: "Express.js"
-runtime: "Node.js (CommonJS or ESM)"
-client_directive: ""                    # Server-only — not applicable
-server_client_boundary: false           # Server-only application
-```
-
-## Code Style
-
-```yaml
-language: "TypeScript"
-strict_mode: true
-type_keyword: "type"                    # Use type instead of interface
-import_type: true                       # Use import type { ... }
-component_style: ""                     # No UI components
-props_position: ""                      # No UI components
-handler_naming: "camelCase"
-boolean_naming: "is/has/can[State]"
-constant_naming: "UPPER_SNAKE_CASE"
-any_policy: "banned (use unknown with strict mode)"
-```
-
-## State Management
-
-```yaml
-global_state: ""                        # Server — stateless
-server_state: ""
-local_state: ""
-store_location: ""
-query_location: ""
-```
-
-## Styling
-
-```yaml
-framework: ""                           # Not applicable
-```
-
-## Testing
-
-```yaml
-framework: "Jest + Supertest"
-```
-
-## Project-Specific Risks
-
-> Project-specific risk patterns that must be checked in the Plan's RISK Critic
-
-1. Prisma migration and schema mismatch
-2. Express middleware ordering errors (auth → validation → handler)
-3. Missing async/await error handling (try-catch or wrapper)
-4. Runtime errors when environment variables (.env) are not set
-5. SQL injection (caution with raw queries when using Prisma)
-
-## Mini-Review Checklist
-
-> Items to inspect for each file in the Mini-Review of the Implement Phase gate
-
-1. TypeScript strict mode violations
-2. Error handling (try-catch or asyncHandler on async routes)
-3. Input validation (type checking of req.body/params/query)
-4. Unused imports / dead code

package/templates/afc.config.monorepo.md

@@ -1,98 +0,0 @@
-# AFC Configuration
-
-> This file defines project-specific settings for the afc command system.
-> All afc commands reference this file to determine project-specific behavior.
-
-## CI Commands
-
-```yaml
-ci: "pnpm turbo build lint test"        # Full CI (lint + typecheck + build)
-typecheck: "pnpm turbo typecheck"       # Typecheck only
-lint: "pnpm turbo lint"                 # Lint only
-lint_fix: "pnpm turbo lint -- --fix"   # Auto-fix lint
-gate: "pnpm turbo typecheck lint"       # Phase gate (run repeatedly during implement)
-test: "pnpm turbo test"                 # Tests
-```
-
-## Architecture
-
-```yaml
-style: "Monorepo"
-layers:                                 # Root → package order
-  - apps/
-  - packages/
-import_rule: "apps/ may only import from packages/. packages/ must declare explicit dependencies (package.json)"
-segments:
-  - apps/web       # Web app
-  - apps/api       # API server
-  - packages/ui    # Shared UI components
-  - packages/config   # Shared configuration (ESLint, Prettier, etc.)
-  - packages/tsconfig # Shared TypeScript configuration
-  - packages/utils    # Shared utilities
-path_alias: "@repo/* → packages/*"
-```
-
-## Framework
-
-```yaml
-name: "Turborepo + pnpm workspace"
-runtime: "Multiple (varies per app)"
-client_directive: "Varies per app"
-server_client_boundary: "Varies per app"    # Determined by each app's framework
-```
-
-## Code Style
-
-```yaml
-language: "TypeScript"
-strict_mode: true
-type_keyword: "type"                    # Use type instead of interface
-import_type: true                       # Use import type { ... }
-component_style: "PascalCase"
-props_position: "above component"       # Define Props type above the component
-handler_naming: "handle[Event]"
-boolean_naming: "is/has/can[State]"
-constant_naming: "UPPER_SNAKE_CASE"
-any_policy: "minimize (especially strict for shared packages)"
-```
-
-## State Management
-
-```yaml
-global_state: "Varies per app"
-server_state: "Varies per app"
-local_state: "Varies per app"
-store_location: "Within each app"
-query_location: "Within each app"
-```
-
-## Styling
-
-```yaml
-framework: "Varies per app (shared UI package uses Tailwind CSS)"
-```
-
-## Testing
-
-```yaml
-framework: "Varies per app (Vitest or Jest)"
-```
-
-## Project-Specific Risks
-
-> Project-specific risk patterns that must be checked in the Plan's RISK Critic
-
-1. Circular dependencies between packages (turborepo detects, but runtime errors possible)
-2. Build failures in dependent apps when shared packages change
-3. npm publish errors when pnpm workspace protocol (workspace:*) is missing
-4. tsconfig inheritance chain mismatch (extends path errors)
-5. Stale builds due to incorrect pipeline cache settings in turbo.json
-
-## Mini-Review Checklist
-
-> Items to inspect for each file in the Mini-Review of the Implement Phase gate
-
-1. Dependency direction between packages (apps → packages only)
-2. Shared package export paths (package.json exports field)
-3. TypeScript strict mode + path alias consistency
-4. turbo.json pipeline configuration matches actual scripts

package/templates/afc.config.nextjs-fsd.md

@@ -1,107 +0,0 @@
-# AFC Configuration
-
-> This file defines project-specific settings for the afc command system.
-> All afc commands reference this file to determine project-specific behavior.
-
-## CI Commands
-
-```yaml
-ci: "yarn ci"                           # Full CI (lint + typecheck + build)
-typecheck: "yarn typecheck"             # Typecheck only
-lint: "yarn lint"                       # Lint only
-lint_fix: "yarn lint:fix"               # Auto-fix lint
-gate: "yarn typecheck && yarn lint"     # Phase gate (run repeatedly during implement)
-test: "yarn test"                       # Tests
-```
-
-## Architecture
-
-```yaml
-style: "FSD"                            # Feature-Sliced Design
-layers:                                 # Top → bottom order
-  - app
-  - views
-  - widgets
-  - features
-  - entities
-  - shared
-  - core
-import_rule: "Upper layers may only import from lower layers (no reverse direction)"
-segments:
-  - api       # API-related logic (React Query hooks)
-  - model     # State management and type definitions
-  - ui        # UI components
-  - lib       # Utility functions
-  - config    # Configuration and constants
-  - hooks     # Custom hooks
-path_alias: "@/* → ./src/*"
-```
-
-## Framework
-
-```yaml
-name: "Next.js 14"
-runtime: "App Router"
-client_directive: "'use client'"
-client_directive_rule: >
-  Files using client hooks such as useState/useEffect/useRef must
-  declare 'use client'. Pay special attention when indirectly imported
-  from server components via barrel exports (index.ts).
-server_client_boundary: true            # Server/client boundary exists
-```
-
-## Code Style
-
-```yaml
-language: "TypeScript"
-strict_mode: true
-type_keyword: "type"                    # Use type instead of interface
-import_type: true                       # Use import type { ... }
-component_style: "PascalCase"
-props_position: "above component"       # Define Props type above the component
-handler_naming: "handle[Event]"
-boolean_naming: "is/has/can[State]"
-constant_naming: "UPPER_SNAKE_CASE"
-any_policy: "minimize (comply with strict mode)"
-```
-
-## State Management
-
-```yaml
-global_state: "Zustand"
-server_state: "React Query v5"
-local_state: "Context API (use-context-selector)"
-store_location: "model/ segment"
-query_location: "api/ segment"
-```
-
-## Styling
-
-```yaml
-framework: "Tailwind CSS v3"
-```
-
-## Testing
-
-```yaml
-framework: "Jest + React Testing Library"
-```
-
-## Project-Specific Risks
-
-> Project-specific risk patterns that must be checked in the Plan's RISK Critic
-
-1. Missing `'use client'` in barrel export chain → build failure
-2. Import order violation (ESLint FSD import order)
-3. Circular reference (when using barrel imports inside shared/ui)
-4. FSD layer reverse import
-5. Residual `as any` → typecheck bypass
-
-## Mini-Review Checklist
-
-> Items to inspect for each file in the Mini-Review of the Implement Phase gate
-
-1. Whether `'use client'` is required (mandatory when using client hooks)
-2. FSD layer violations (M violations out of N import paths)
-3. Project patterns (`type` vs `interface`, naming, import order)
-4. Dead code (unused imports, empty exports, dead code)

package/templates/afc.config.react-spa.md

@@ -1,96 +0,0 @@
-# AFC Configuration
-
-> This file defines project-specific settings for the afc command system.
-> All afc commands reference this file to determine project-specific behavior.
-
-## CI Commands
-
-```yaml
-ci: "npm run build && npm run lint && npm run test"  # Full CI (build + lint + test)
-typecheck: "npx tsc --noEmit"                        # Typecheck only
-lint: "npx eslint src/"                              # Lint only
-lint_fix: "npx eslint src/ --fix"                    # Auto-fix lint
-gate: "npx tsc --noEmit && npx eslint src/"          # Phase gate (run repeatedly during implement)
-test: "npx vitest run"                               # Tests
-```
-
-## Architecture
-
-```yaml
-style: "Modular"
-layers:                                 # Role-based separation structure
-  - src/components
-  - src/features
-  - src/hooks
-  - src/lib
-  - src/stores
-  - src/types
-  - src/api
-import_rule: "No direct imports between features/ (route via shared)"
-segments: []
-path_alias: "@/* → ./src/*"
-```
-
-## Framework
-
-```yaml
-name: "Vite + React 18"
-runtime: "SPA (Client-Side)"
-client_directive: ""                    # Not needed for SPA
-server_client_boundary: false           # No server/client boundary
-```
-
-## Code Style
-
-```yaml
-language: "TypeScript"
-strict_mode: true
-type_keyword: "type"                    # Use type instead of interface
-import_type: true                       # Use import type { ... }
-component_style: "PascalCase"
-props_position: "above component"       # Define Props type above the component
-handler_naming: "handle[Event]"
-boolean_naming: "is/has/can[State]"
-constant_naming: "UPPER_SNAKE_CASE"
-any_policy: "minimize (comply with strict mode)"
-```
-
-## State Management
-
-```yaml
-global_state: "Zustand"
-server_state: "React Query v5"
-local_state: "useState / useReducer"
-store_location: "src/stores/"
-query_location: "src/api/"
-```
-
-## Styling
-
-```yaml
-framework: "Tailwind CSS v3"
-```
-
-## Testing
-
-```yaml
-framework: "Vitest + React Testing Library"
-```
-
-## Project-Specific Risks
-
-> Project-specific risk patterns that must be checked in the Plan's RISK Critic
-
-1. Missing environment variables when building with Vite HMR disabled
-2. Stale data displayed due to missing React Query cache invalidation
-3. Unnecessary re-renders when selectors are not used in Zustand store
-4. Mismatch between path alias and Vite resolve.alias
-
-## Mini-Review Checklist
-
-> Items to inspect for each file in the Mini-Review of the Implement Phase gate
-
-1. TypeScript strict mode violations (any, as unknown)
-2. Whether import paths use path alias (@/)
-3. React hooks rules (no conditional hook calls)
-4. Unused imports / dead code