@pixelcraft-tw/spec 1.0.0

package/dist/src/state/types.d.ts

@@ -0,0 +1,48 @@
+export type Phase = 'spec_created' | 'clarifying' | 'spec_approved' | 'plan_pending_approval' | 'ready_to_implement' | 'implementing' | 'completed' | 'merged';
+export type TaskStatus = 'pending' | 'in_progress' | 'review_pending' | 'complete' | 'skipped';
+export type FeatureType = 'feat' | 'fix' | 'refactor' | 'docs' | 'chore';
+export type TestStrategy = 'tdd' | 'after' | 'none';
+export type TestType = 'unit' | 'intg' | 'both';
+export interface TaskState {
+    name: string;
+    status: TaskStatus;
+}
+export interface SessionInfo {
+    backend: string;
+    id: string;
+}
+export interface FeatureState {
+    feature: string;
+    type: FeatureType;
+    branch: string;
+    base_branch?: string;
+    phase: Phase;
+    total_tasks: number;
+    current_task: number;
+    session?: SessionInfo;
+    tasks: TaskState[];
+}
+export interface WorkflowState {
+    features: FeatureState[];
+}
+export interface ProjectConfig {
+    project: {
+        name: string;
+        language: string;
+        framework: string;
+        architecture: string;
+        lang_framework: string;
+    };
+    git: {
+        convention: string;
+    };
+    backend: {
+        default: string;
+    };
+    test: {
+        strategy: TestStrategy;
+        type: TestType;
+    };
+}
+export declare const PHASE_GUARDS: Record<string, Phase[]>;
+export declare const TASK_TRANSITIONS: Record<TaskStatus, TaskStatus[]>;

package/dist/src/state/types.js

@@ -0,0 +1,20 @@
+// Phase guard: which phases each command is allowed in
+export const PHASE_GUARDS = {
+    new: [], // any phase (creates new feature)
+    refine: ['spec_created', 'clarifying'],
+    clarify: ['spec_created', 'spec_approved', 'plan_pending_approval'],
+    implement: ['ready_to_implement', 'implementing'],
+    review: ['implementing', 'completed'],
+    status: [], // any phase
+    reset: [], // any phase
+    diff: ['ready_to_implement', 'implementing', 'completed', 'merged'],
+};
+// Valid task status transitions
+export const TASK_TRANSITIONS = {
+    pending: ['in_progress', 'skipped'],
+    in_progress: ['review_pending'],
+    review_pending: ['complete', 'in_progress'], // in_progress = request-change
+    complete: [],
+    skipped: [],
+};
+//# sourceMappingURL=types.js.map

package/dist/src/state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/state/types.ts"],"names":[],"mappings":"AA+DA,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAA4B;IACnD,GAAG,EAAE,EAAE,EAAE,kCAAkC;IAC3C,MAAM,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,OAAO,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,uBAAuB,CAAC;IACnE,SAAS,EAAE,CAAC,oBAAoB,EAAE,cAAc,CAAC;IACjD,MAAM,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,MAAM,EAAE,EAAE,EAAE,YAAY;IACxB,KAAK,EAAE,EAAE,EAAE,YAAY;IACvB,IAAI,EAAE,CAAC,oBAAoB,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,CAAC;CACpE,CAAC;AAEF,gCAAgC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,OAAO,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC;IACnC,WAAW,EAAE,CAAC,gBAAgB,CAAC;IAC/B,cAAc,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,+BAA+B;IAC5E,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;CACZ,CAAC"}

package/dist/src/utils/display.d.ts

@@ -0,0 +1,7 @@
+export declare function heading(text: string): void;
+export declare function success(text: string): void;
+export declare function error(text: string): void;
+export declare function warn(text: string): void;
+export declare function info(text: string): void;
+export declare function taskIcon(status: string): string;
+export declare function table(headers: string[], rows: string[][]): void;

package/dist/src/utils/display.js

@@ -0,0 +1,42 @@
+import chalk from 'chalk';
+export function heading(text) {
+    console.log(chalk.bold.cyan(`\n━━━ ${text} ━━━\n`));
+}
+export function success(text) {
+    console.log(chalk.green(`  ✓ ${text}`));
+}
+export function error(text) {
+    console.log(chalk.red(`  ✗ ${text}`));
+}
+export function warn(text) {
+    console.log(chalk.yellow(`  ⚠ ${text}`));
+}
+export function info(text) {
+    console.log(chalk.gray(`  ℹ ${text}`));
+}
+export function taskIcon(status) {
+    switch (status) {
+        case 'complete': return '✅';
+        case 'in_progress': return '⏳';
+        case 'skipped': return '⏭️';
+        case 'review_pending': return '🔍';
+        case 'pending':
+        default: return '⬜';
+    }
+}
+export function table(headers, rows) {
+    // Calculate column widths
+    const widths = headers.map((h, i) => {
+        const colValues = [h, ...rows.map((r) => r[i] ?? '')];
+        return Math.max(...colValues.map((v) => v.length));
+    });
+    // Print header
+    const headerLine = headers.map((h, i) => h.padEnd(widths[i])).join('  ');
+    console.log(chalk.bold(headerLine));
+    // Print rows
+    for (const row of rows) {
+        const line = row.map((cell, i) => (cell ?? '').padEnd(widths[i])).join('  ');
+        console.log(line);
+    }
+}
+//# sourceMappingURL=display.js.map

package/dist/src/utils/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../src/utils/display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU,CAAC,CAAC,OAAO,GAAG,CAAC;QAC5B,KAAK,aAAa,CAAC,CAAC,OAAO,GAAG,CAAC;QAC/B,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC;QAC5B,KAAK,gBAAgB,CAAC,CAAC,OAAO,IAAI,CAAC;QACnC,KAAK,SAAS,CAAC;QACf,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAiB,EAAE,IAAgB;IACvD,0BAA0B;IAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAClC,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEpC,aAAa;IACb,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/src/utils/prompt.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Load a prompt template from .workflow/prompts/<name>.md
+ */
+export declare function loadPrompt(name: string, cwd?: string): string;
+/**
+ * Assemble a full prompt from template name + variables + agents/skills + extra text.
+ */
+export declare function assemblePrompt(opts: {
+    templateName: string;
+    vars: Record<string, string>;
+    agents?: string[];
+    skills?: string[];
+    extraText?: string;
+    cwd?: string;
+}): string;

package/dist/src/utils/prompt.js

@@ -0,0 +1,139 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const WORKFLOW_DIR = '.workflow';
+/**
+ * Load a prompt template from .workflow/prompts/<name>.md
+ */
+export function loadPrompt(name, cwd = process.cwd()) {
+    const promptPath = path.join(cwd, WORKFLOW_DIR, 'prompts', `${name}.md`);
+    if (!fs.existsSync(promptPath)) {
+        throw new Error(`Prompt template "${name}" not found at ${promptPath}`);
+    }
+    return fs.readFileSync(promptPath, 'utf-8');
+}
+/**
+ * Substitute template variables in a prompt string.
+ * Variables use {varName} syntax.
+ */
+function renderPrompt(template, vars) {
+    let result = template;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replaceAll(`{${key}}`, value);
+    }
+    return result;
+}
+/**
+ * Build the agent/skill instruction block for prompt injection.
+ */
+function buildAgentSkillBlock(agents, skills) {
+    const parts = [];
+    if (agents.length > 0) {
+        parts.push(`\n## Agent Instructions\nInvolve the following agents in analysis: ${agents.map(a => `@${a}`).join(', ')}`);
+    }
+    if (skills.length > 0) {
+        parts.push(`\n## Skill/MCP Instructions\nUse the following skills/MCPs to assist: ${skills.map(s => `/${s}`).join(', ')}`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Assemble a full prompt from template name + variables + agents/skills + extra text.
+ */
+/**
+ * Load architecture constraints from .workflow/architecture.md if it exists.
+ */
+function loadArchitectureConstraint(cwd = process.cwd()) {
+    const archPath = path.join(cwd, WORKFLOW_DIR, 'architecture.md');
+    if (!fs.existsSync(archPath))
+        return '';
+    const content = fs.readFileSync(archPath, 'utf-8');
+    return `\n## Architecture Constraint
+This project follows the architecture specification below. All implementations must comply:
+${content}
+
+<HARD-GATE>
+- New files must be placed in the correct directory as defined by the architecture
+- Dependency direction must not be violated (e.g., domain must not reference infrastructure)
+- Follow the architecture's naming conventions and file naming rules
+- If requirements cross layers, use Port/Adapter or the corresponding architectural pattern
+- NestJS projects: new features must create independent Modules; do not stuff logic into unrelated Modules
+</HARD-GATE>`;
+}
+/**
+ * Discover review-related slash commands and skills in the project.
+ * Scans .claude/commands/ for review-related files.
+ */
+function discoverReviewTools(cwd = process.cwd()) {
+    const commands = [];
+    const skills = [];
+    // Scan .claude/commands/ for review-related slash commands
+    const commandsDir = path.join(cwd, '.claude', 'commands');
+    if (fs.existsSync(commandsDir)) {
+        try {
+            const files = fs.readdirSync(commandsDir);
+            for (const file of files) {
+                if (!file.endsWith('.md'))
+                    continue;
+                const name = file.replace('.md', '');
+                const lower = name.toLowerCase();
+                if (lower.includes('review') || lower.includes('simplify') || lower.includes('lint')
+                    || lower.includes('audit') || lower.includes('check')) {
+                    commands.push(`/${name}`);
+                }
+            }
+        }
+        catch {
+            // ignore read errors
+        }
+    }
+    // Well-known review skills available in Claude Code
+    const knownReviewSkills = ['simplify', 'code-review'];
+    skills.push(...knownReviewSkills);
+    return { commands, skills };
+}
+/**
+ * Build auto-discovery block for review prompts when no agents/skills are provided.
+ */
+function buildReviewAutoDiscoveryBlock(cwd = process.cwd()) {
+    const { commands, skills } = discoverReviewTools(cwd);
+    const parts = [];
+    parts.push('\n## Review Tool Instructions');
+    parts.push('You MUST perform a thorough code review. Do NOT just summarize the git diff.');
+    parts.push('Analyze the actual code changes for correctness, security, performance, and quality.');
+    if (commands.length > 0) {
+        parts.push(`\nAvailable project review commands: ${commands.join(', ')}`);
+        parts.push('Consider using these to assist the review.');
+    }
+    if (skills.length > 0) {
+        parts.push(`\nAvailable review skills: ${skills.map(s => `/${s}`).join(', ')}`);
+        parts.push('Use /simplify or /code-review if available to perform deeper analysis.');
+    }
+    return parts.join('\n');
+}
+const REVIEW_TEMPLATES = ['review', 'final-review'];
+/**
+ * Assemble a full prompt from template name + variables + agents/skills + extra text.
+ */
+export function assemblePrompt(opts) {
+    const template = loadPrompt(opts.templateName, opts.cwd);
+    let prompt = renderPrompt(template, opts.vars);
+    // Auto-append architecture constraints when architecture.md exists
+    const archConstraint = loadArchitectureConstraint(opts.cwd);
+    if (archConstraint) {
+        prompt += archConstraint;
+    }
+    const agents = opts.agents ?? [];
+    const skills = opts.skills ?? [];
+    const agentSkillBlock = buildAgentSkillBlock(agents, skills);
+    if (agentSkillBlock) {
+        prompt += '\n' + agentSkillBlock;
+    }
+    // For review templates: inject auto-discovery when no agents/skills are provided
+    if (REVIEW_TEMPLATES.includes(opts.templateName) && agents.length === 0 && skills.length === 0) {
+        prompt += buildReviewAutoDiscoveryBlock(opts.cwd);
+    }
+    if (opts.extraText) {
+        prompt += `\n\n## Additional Instructions\n${opts.extraText}`;
+    }
+    return prompt;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/src/utils/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/utils/prompt.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@pixelcraft-tw/spec",
+  "version": "1.0.0",
+  "description": "Lightweight spec-driven development CLI",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "spec-driven",
+    "claude-code",
+    "ai",
+    "cli",
+    "workflow"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pixelcraft-tw/spec-cli.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "pxs": "./dist/bin/pxs.js"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc",
+    "dev": "tsx watch bin/pxs.ts",
+    "test": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "inquirer": "^12.6.0",
+    "js-yaml": "^4.1.0"
+  },
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.15.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  }
+}

package/templates/agents-md-snippet.md

@@ -0,0 +1,20 @@
+## SF Spec-Driven Workflow
+
+This project uses sf for spec-driven development.
+
+### Workflow State
+- Read `.workflow/state.yaml` for current progress
+- Read `.workflow/plans/<feature>.md` for implementation plan
+
+### Rules
+- Implement tasks in the order specified in the plan; do not skip
+- After completing each task, run `git add -A && git commit`
+- Commit messages follow conventional commits or the project's custom convention
+- Do not implement beyond task spec scope
+- After each task completion, wait for user confirmation before continuing
+
+### Prompt Templates
+- Implementation guide: `.workflow/prompts/implement.md`
+- TDD guide: `.workflow/prompts/implement-tdd.md`
+- Review guide: `.workflow/prompts/review.md`
+- Test guide: `.workflow/prompts/test.md`

package/templates/architectures/clean/csharp-aspnet.md

@@ -0,0 +1,56 @@
+# Architecture: Clean Architecture (C# + ASP.NET Core)
+
+## Project Structure
+```
+src/
+├── Domain/
+│   ├── Entities/Order.cs
+│   ├── ValueObjects/Money.cs
+│   ├── Events/OrderCreatedEvent.cs
+│   ├── Errors/DomainException.cs
+│   └── Interfaces/IOrderRepository.cs
+├── Application/
+│   ├── UseCases/CreateOrder/
+│   │   ├── CreateOrderCommand.cs
+│   │   ├── CreateOrderHandler.cs
+│   │   └── CreateOrderValidator.cs
+│   ├── Common/
+│   │   └── Behaviors/ValidationBehavior.cs
+│   └── DependencyInjection.cs
+├── Infrastructure/
+│   ├── Persistence/
+│   │   ├── ApplicationDbContext.cs
+│   │   ├── Repositories/OrderRepository.cs
+│   │   └── Configurations/OrderConfiguration.cs
+│   ├── Services/
+│   │   └── PaymentGateway.cs
+│   └── DependencyInjection.cs
+└── WebApi/
+    ├── Controllers/OrderController.cs
+    ├── Middleware/ExceptionHandlerMiddleware.cs
+    ├── Filters/
+    └── Program.cs
+```
+
+## Dependency Rule
+- Domain → depends on nothing outside, pure C# classes
+- Application → depends only on Domain; uses MediatR for CQRS
+- Infrastructure → implements Domain interfaces, EF Core DbContext
+- WebApi → depends on Application; ASP.NET Controllers + minimal APIs
+
+## Conventions
+- MediatR for Command/Query handling
+- FluentValidation for input validation
+- EF Core with Fluent API configuration (no data annotations on Domain)
+- DI registration in each layer's DependencyInjection.cs
+
+## File Naming
+- PascalCase: CreateOrderCommand.cs
+- One class per file
+- Folder-per-feature in Application (e.g., UseCases/CreateOrder/)
+
+## Testing
+- Domain: pure unit tests (xUnit)
+- Application: mock repositories (NSubstitute/Moq)
+- Infrastructure: integration tests (WebApplicationFactory, TestContainers)
+- WebApi: E2E tests (WebApplicationFactory)

package/templates/architectures/clean/dart-flutter.md

@@ -0,0 +1,73 @@
+# Architecture: Clean Architecture (Flutter)
+
+## Layer-Based Structure
+Flutter app organized into domain, application, infrastructure, and presentation layers under `lib/`.
+
+## Directory Structure
+```
+lib/
+├── domain/
+│   ├── entities/order.dart
+│   ├── value_objects/money.dart
+│   └── errors/domain_error.dart
+├── application/
+│   ├── use_cases/create_order_use_case.dart
+│   ├── ports/
+│   │   ├── order_repository_port.dart
+│   │   └── payment_gateway_port.dart
+│   └── dtos/create_order_dto.dart
+├── infrastructure/
+│   ├── repositories/order_repository.dart
+│   ├── services/payment_gateway.dart
+│   ├── database/
+│   │   └── app_database.dart
+│   └── config/env.dart
+├── presentation/
+│   ├── pages/order_page.dart
+│   ├── widgets/order_card.dart
+│   ├── providers/order_provider.dart
+│   └── router/app_router.dart
+└── main.dart
+test/
+├── domain/
+├── application/
+├── infrastructure/
+└── presentation/
+integration_test/
+└── app_test.dart
+```
+
+## Dependency Rule
+- domain → depends on nothing outside, pure Dart classes
+- application → depends only on domain; use cases call externals via port abstract classes
+- infrastructure → implements application ports
+- presentation → depends on application; widgets + providers
+
+## Recommended Dependencies
+- State Management: Riverpod + flutter_hooks
+- Networking: dio + retrofit
+- Navigation: go_router
+- Local Storage: drift (SQL), shared_preferences (KV)
+- DI: Riverpod (self-contained)
+
+## Conventions
+- Use Cases are single-purpose classes with a `call()` method
+- Providers (Riverpod) expose use cases and state to UI
+- Presentation layer never imports infrastructure directly
+- Error handling via Either pattern or sealed result classes
+
+## File Naming
+- snake_case: create_order_use_case.dart
+- Entity: *_entity.dart or just *.dart under entities/
+- Port: *_port.dart
+- Repository: *_repository.dart
+- Provider: *_provider.dart
+- Page: *_page.dart
+- Widget: *_widget.dart or descriptive name
+
+## Testing
+- domain: pure unit tests, no mocks
+- application: mock ports
+- infrastructure: integration tests
+- presentation: widget tests with WidgetTester
+- integration_test/: full app flow tests

package/templates/architectures/clean/go-gin.md

@@ -0,0 +1,50 @@
+# Architecture: Clean Architecture (Go + Gin)
+
+## Directory Structure
+```
+internal/
+├── domain/
+│   ├── entity/order.go            # Entities, Value Objects
+│   └── event/order_created.go     # Domain Events
+├── usecase/
+│   ├── create_order.go            # Use Cases (one file per use case)
+│   └── interfaces.go              # Port interfaces
+├── infrastructure/
+│   ├── postgres/
+│   │   └── order_repo.go          # Repository implementation
+│   ├── redis/
+│   │   └── cache.go               # Cache implementation (if any)
+│   └── config/
+│       └── env.go                 # Environment configuration
+├── handler/
+│   └── http/
+│       ├── order_handler.go       # Gin handler
+│       ├── middleware/
+│       │   └── auth.go            # Middleware
+│       └── router.go              # Route definitions
+└── pkg/                           # Cross-project reusable packages
+    └── logger/
+```
+
+## Dependency Rule
+- domain → depends on nothing outside, pure Go structs and interfaces
+- usecase → depends only on domain; calls infrastructure through interfaces
+- infrastructure → implements usecase interfaces
+- handler → depends on usecase; handles HTTP layer
+
+## Go Conventions
+- Interfaces defined at the consumer side (usecase/), not implementation side (infrastructure/)
+- Error handling uses custom error types defined in domain/
+- Struct initialization uses New functions: NewOrderUseCase(), NewOrderRepo()
+- Context passed throughout: handler → usecase → repository
+
+## File Naming
+- snake_case: create_order.go
+- Test files: create_order_test.go
+- One type per file within same package
+
+## Testing
+- domain: pure unit tests
+- usecase: mock interfaces (using mockgen or hand-written mocks)
+- infrastructure: integration tests (using testcontainers or test DB)
+- handler: HTTP tests (using httptest)

package/templates/architectures/clean/go-std.md

@@ -0,0 +1,49 @@
+# Architecture: Clean Architecture (Go Standard Library)
+
+## Directory Structure
+```
+internal/
+├── domain/
+│   ├── entity/order.go            # Entities, Value Objects
+│   └── errors.go                  # Domain errors
+├── usecase/
+│   ├── create_order.go            # Use Cases
+│   └── interfaces.go              # Port interfaces
+├── infrastructure/
+│   ├── postgres/
+│   │   └── order_repo.go          # Repository implementation
+│   └── config/
+│       └── env.go                 # Environment configuration
+├── handler/
+│   └── http/
+│       ├── order_handler.go       # net/http handler
+│       ├── middleware/
+│       │   └── auth.go            # Middleware
+│       └── router.go              # http.ServeMux routes
+└── pkg/
+    └── logger/
+```
+
+## Dependency Rule
+- domain → depends on nothing outside, pure Go structs and interfaces
+- usecase → depends only on domain; calls infrastructure through interfaces
+- infrastructure → implements usecase interfaces
+- handler → depends on usecase; handles HTTP layer using net/http
+
+## Go Conventions
+- Use net/http ServeMux (Go 1.22+ enhanced routing) instead of external routers
+- Interfaces defined at the consumer side (usecase/)
+- Error handling uses custom error types defined in domain/
+- Struct initialization uses New functions
+- Context passed throughout: handler → usecase → repository
+
+## File Naming
+- snake_case: create_order.go
+- Test files: create_order_test.go
+- One type per file within same package
+
+## Testing
+- domain: pure unit tests
+- usecase: mock interfaces
+- infrastructure: integration tests (using testcontainers)
+- handler: HTTP tests (using httptest)

package/templates/architectures/clean/kotlin-android.md

@@ -0,0 +1,70 @@
+# Architecture: Clean Architecture (Android / Kotlin)
+
+## Layer-Based Structure
+Android app organized into domain, data, and presentation packages following Clean Architecture with Jetpack Compose.
+
+## Directory Structure
+```
+app/src/main/java/com/example/app/
+├── domain/
+│   ├── model/Order.kt
+│   ├── repository/OrderRepository.kt          # interface
+│   ├── usecase/CreateOrderUseCase.kt
+│   └── error/DomainError.kt
+├── data/
+│   ├── repository/OrderRepositoryImpl.kt
+│   ├── remote/
+│   │   ├── api/OrderApi.kt                    # Retrofit interface
+│   │   └── dto/OrderDto.kt
+│   ├── local/
+│   │   ├── dao/OrderDao.kt                    # Room DAO
+│   │   └── entity/OrderEntity.kt
+│   └── mapper/OrderMapper.kt
+├── presentation/
+│   ├── order/
+│   │   ├── OrderScreen.kt
+│   │   └── OrderViewModel.kt
+│   ├── navigation/AppNavigation.kt
+│   └── theme/Theme.kt
+├── di/
+│   ├── AppModule.kt
+│   ├── NetworkModule.kt
+│   └── DatabaseModule.kt
+└── App.kt                                     # Application class
+app/src/test/                                   # Unit tests
+app/src/androidTest/                            # Instrumented tests
+```
+
+## Dependency Rule
+- domain → depends on nothing outside, pure Kotlin classes + interfaces
+- data → implements domain repository interfaces
+- presentation → depends on domain; Compose screens + ViewModels
+- di → wires everything together via Hilt modules
+
+## Recommended Dependencies
+- State Management: Hilt + StateFlow + Compose State
+- Networking: Retrofit + OkHttp
+- DI: Hilt
+- Navigation: Navigation Compose
+- Local Storage: Room
+- Async: Kotlin Coroutines + Flow
+
+## Conventions
+- Use Cases are single-purpose classes with an `operator fun invoke()` or `execute()` method
+- ViewModels extend `ViewModel()`, expose `StateFlow` to Compose
+- Repository interfaces live in domain, implementations in data
+- Hilt @Module classes in di/ package
+
+## File Naming
+- PascalCase: CreateOrderUseCase.kt
+- Interface: OrderRepository.kt (domain), OrderRepositoryImpl.kt (data)
+- DAO: *Dao.kt
+- API: *Api.kt
+- Screen: *Screen.kt
+- ViewModel: *ViewModel.kt
+
+## Testing
+- domain: pure unit tests, JUnit
+- data: integration tests with Room in-memory DB
+- presentation: Compose UI tests with composeTestRule
+- Use Cases: unit test with mock repositories