ai-devkit 0.4.2 → 0.6.0

package/dist/templates/templates/phases/requirements.md

@@ -0,0 +1,51 @@
+---
+phase: requirements
+title: Requirements & Problem Understanding
+description: Clarify the problem space, gather requirements, and define success criteria
+---
+
+# Requirements & Problem Understanding
+
+## Problem Statement
+**What problem are we solving?**
+
+- Describe the core problem or pain point
+- Who is affected by this problem?
+- What is the current situation/workaround?
+
+## Goals & Objectives
+**What do we want to achieve?**
+
+- Primary goals
+- Secondary goals
+- Non-goals (what's explicitly out of scope)
+
+## User Stories & Use Cases
+**How will users interact with the solution?**
+
+- As a [user type], I want to [action] so that [benefit]
+- Key workflows and scenarios
+- Edge cases to consider
+
+## Success Criteria
+**How will we know when we're done?**
+
+- Measurable outcomes
+- Acceptance criteria
+- Performance benchmarks (if applicable)
+
+## Constraints & Assumptions
+**What limitations do we need to work within?**
+
+- Technical constraints
+- Business constraints
+- Time/budget constraints
+- Assumptions we're making
+
+## Questions & Open Items
+**What do we still need to clarify?**
+
+- Unresolved questions
+- Items requiring stakeholder input
+- Research needed
+

package/dist/templates/templates/phases/testing.md

@@ -0,0 +1,81 @@
+---
+phase: testing
+title: Testing Strategy
+description: Define testing approach, test cases, and quality assurance
+---
+
+# Testing Strategy
+
+## Test Coverage Goals
+**What level of testing do we aim for?**
+
+- Unit test coverage target (default: 100% of new/changed code)
+- Integration test scope (critical paths + error handling)
+- End-to-end test scenarios (key user journeys)
+- Alignment with requirements/design acceptance criteria
+
+## Unit Tests
+**What individual components need testing?**
+
+### Component/Module 1
+- [ ] Test case 1: [Description] (covers scenario / branch)
+- [ ] Test case 2: [Description] (covers edge case / error handling)
+- [ ] Additional coverage: [Description]
+
+### Component/Module 2
+- [ ] Test case 1: [Description]
+- [ ] Test case 2: [Description]
+- [ ] Additional coverage: [Description]
+
+## Integration Tests
+**How do we test component interactions?**
+
+- [ ] Integration scenario 1
+- [ ] Integration scenario 2
+- [ ] API endpoint tests
+- [ ] Integration scenario 3 (failure mode / rollback)
+
+## End-to-End Tests
+**What user flows need validation?**
+
+- [ ] User flow 1: [Description]
+- [ ] User flow 2: [Description]
+- [ ] Critical path testing
+- [ ] Regression of adjacent features
+
+## Test Data
+**What data do we use for testing?**
+
+- Test fixtures and mocks
+- Seed data requirements
+- Test database setup
+
+## Test Reporting & Coverage
+**How do we verify and communicate test results?**
+
+- Coverage commands and thresholds (`npm run test -- --coverage`)
+- Coverage gaps (files/functions below 100% and rationale)
+- Links to test reports or dashboards
+- Manual testing outcomes and sign-off
+
+## Manual Testing
+**What requires human validation?**
+
+- UI/UX testing checklist (include accessibility)
+- Browser/device compatibility
+- Smoke tests after deployment
+
+## Performance Testing
+**How do we validate performance?**
+
+- Load testing scenarios
+- Stress testing approach
+- Performance benchmarks
+
+## Bug Tracking
+**How do we manage issues?**
+
+- Issue tracking process
+- Bug severity levels
+- Regression testing strategy
+

package/dist/types.d.ts

@@ -7,8 +7,9 @@ export interface EnvironmentDefinition {
     description?: string;
     isCustomCommandPath?: boolean;
     customCommandExtension?: string;
+    globalCommandPath?: string;
 }
-export type EnvironmentCode = 'cursor' | 'claude' | 'github' | 'gemini' | 'codex' | 'windsurf' | 'kilocode' | 'amp' | 'opencode' | 'roo';
+export type EnvironmentCode = 'cursor' | 'claude' | 'github' | 'gemini' | 'codex' | 'windsurf' | 'kilocode' | 'amp' | 'opencode' | 'roo' | 'antigravity';
 export interface DevKitConfig {
     version: string;
     environments: EnvironmentCode[];

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GACb,cAAc,GACd,QAAQ,GACR,UAAU,GACV,gBAAgB,GAChB,SAAS,GACT,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,KAAK,CAAC;AAEzI,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,iBAAiB,EAAE,KAAK,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,EAQnC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAQrD,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GACb,cAAc,GACd,QAAQ,GACR,UAAU,GACV,gBAAgB,GAChB,SAAS,GACT,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,KAAK,GAAG,aAAa,CAAC;AAEzJ,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,iBAAiB,EAAE,KAAK,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,EAQnC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAQrD,CAAC"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAmCa,QAAA,gBAAgB,GAAY;IACvC,cAAc;IACd,QAAQ;IACR,UAAU;IACV,gBAAgB;IAChB,SAAS;IACT,YAAY;IACZ,YAAY;CACb,CAAC;AAEW,QAAA,mBAAmB,GAA0B;IACxD,YAAY,EAAE,sCAAsC;IACpD,MAAM,EAAE,8BAA8B;IACtC,QAAQ,EAAE,mCAAmC;IAC7C,cAAc,EAAE,sBAAsB;IACtC,OAAO,EAAE,kBAAkB;IAC3B,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE,4BAA4B;CACzC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAoCa,QAAA,gBAAgB,GAAY;IACvC,cAAc;IACd,QAAQ;IACR,UAAU;IACV,gBAAgB;IAChB,SAAS;IACT,YAAY;IACZ,YAAY;CACb,CAAC;AAEW,QAAA,mBAAmB,GAA0B;IACxD,YAAY,EAAE,sCAAsC;IACpD,MAAM,EAAE,8BAA8B;IACtC,QAAQ,EAAE,mCAAmC;IAC7C,cAAc,EAAE,sBAAsB;IACtC,OAAO,EAAE,kBAAkB;IAC3B,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE,4BAA4B;CACzC,CAAC"}

package/dist/util/env.d.ts

@@ -8,4 +8,6 @@ export declare function getEnvironmentsByCodes(codes: EnvironmentCode[]): Enviro
 export declare function isValidEnvironmentCode(value: string): value is EnvironmentCode;
 export declare function getEnvironmentDisplayName(envCode: EnvironmentCode): string;
 export declare function validateEnvironmentCodes(envCodes: string[]): EnvironmentCode[];
+export declare function getGlobalCapableEnvironments(): EnvironmentDefinition[];
+export declare function hasGlobalSupport(envCode: EnvironmentCode): boolean;
 //# sourceMappingURL=env.d.ts.map

package/dist/util/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/util/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,eAAe,EAAE,qBAAqB,CA+DlF,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eAAe,EAA8D,CAAC;AAElH,wBAAgB,kBAAkB,IAAI,qBAAqB,EAAE,CAE5D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,qBAAqB,GAAG,SAAS,CAE1F;AAED,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CAE1D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,qBAAqB,EAAE,CAExF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAE9E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAG1E;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,CAiB9E"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/util/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAuElF,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eAAe,EAA8D,CAAC;AAElH,wBAAgB,kBAAkB,IAAI,qBAAqB,EAAE,CAE5D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,qBAAqB,GAAG,SAAS,CAE1F;AAED,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CAE1D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,qBAAqB,EAAE,CAExF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAE9E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAG1E;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,CAiB9E;AAED,wBAAgB,4BAA4B,IAAI,qBAAqB,EAAE,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAGlE"}

package/dist/util/env.js

@@ -8,6 +8,8 @@ exports.getEnvironmentsByCodes = getEnvironmentsByCodes;
 exports.isValidEnvironmentCode = isValidEnvironmentCode;
 exports.getEnvironmentDisplayName = getEnvironmentDisplayName;
 exports.validateEnvironmentCodes = validateEnvironmentCodes;
+exports.getGlobalCapableEnvironments = getGlobalCapableEnvironments;
+exports.hasGlobalSupport = hasGlobalSupport;
 exports.ENVIRONMENT_DEFINITIONS = {
     cursor: {
         code: 'cursor',
@@ -31,7 +33,7 @@ exports.ENVIRONMENT_DEFINITIONS = {
     gemini: {
         code: 'gemini',
         name: 'Google Gemini',
-        contextFileName: 'AGENTS.md',
+        contextFileName: 'GEMINI.md',
         commandPath: '.gemini/commands',
         isCustomCommandPath: true,
     },
@@ -40,6 +42,7 @@ exports.ENVIRONMENT_DEFINITIONS = {
         name: 'OpenAI Codex',
         contextFileName: 'AGENTS.md',
         commandPath: '.codex/commands',
+        globalCommandPath: '.codex/prompts',
     },
     windsurf: {
         code: 'windsurf',
@@ -70,6 +73,13 @@ exports.ENVIRONMENT_DEFINITIONS = {
         name: 'Roo Code',
         contextFileName: 'AGENTS.md',
         commandPath: '.roo/commands',
+    },
+    antigravity: {
+        code: 'antigravity',
+        name: 'Antigravity',
+        contextFileName: 'AGENTS.md',
+        commandPath: '.agent/workflows',
+        globalCommandPath: '.gemini/antigravity/global_workflows',
     }
 };
 exports.ALL_ENVIRONMENT_CODES = Object.keys(exports.ENVIRONMENT_DEFINITIONS);
@@ -108,4 +118,11 @@ function validateEnvironmentCodes(envCodes) {
     }
     return validCodes;
 }
+function getGlobalCapableEnvironments() {
+    return getAllEnvironments().filter(env => env.globalCommandPath !== undefined);
+}
+function hasGlobalSupport(envCode) {
+    const env = getEnvironment(envCode);
+    return env !== undefined && env.globalCommandPath !== undefined;
+}
 //# sourceMappingURL=env.js.map

package/dist/util/env.js.map

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

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "ai-devkit",
-  "version": "0.4.2",
+  "version": "0.6.0",
   "description": "A CLI toolkit for AI-assisted software development with phase templates and environment setup",
   "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "bin": {
     "ai-devkit": "dist/cli.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && cp -R templates dist/templates",
     "dev": "ts-node src/cli.ts",
     "lint": "eslint src --ext .ts",
     "test": "jest",
@@ -26,9 +27,11 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
+    "@ai-devkit/memory": "^0.2.0",
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
     "fs-extra": "^11.2.0",
+    "gray-matter": "^4.0.3",
     "inquirer": "^8.2.6",
     "yaml": "^2.3.4"
   },

package/project.json

@@ -0,0 +1,29 @@
+{
+  "name": "cli",
+  "root": "packages/cli",
+  "sourceRoot": "packages/cli/src",
+  "projectType": "library",
+  "targets": {
+    "build": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "npm run build",
+        "cwd": "packages/cli"
+      }
+    },
+    "test": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "npm run test",
+        "cwd": "packages/cli"
+      }
+    },
+    "lint": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "npm run lint",
+        "cwd": "packages/cli"
+      }
+    }
+  }
+}

package/templates/commands/capture-knowledge.md

@@ -1,7 +1,16 @@
+---
+description: Capture structured knowledge about a code entry point and save it to the knowledge docs.
+---
+
 # Knowledge Capture Assistant
 
 Guide me through creating a structured understanding of a code entry point and saving it to the knowledge docs.
 
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
 ## Step 1: Gather Context
 - Entry point (file, folder, function, API)
 - Why this entry point matters (feature, bug, investigation)

package/templates/commands/check-implementation.md

@@ -1,5 +1,14 @@
+---
+description: Compare implementation with design and requirements docs to ensure alignment.
+---
+
 Compare the current implementation with the design in docs/ai/design/ and requirements in docs/ai/requirements/. Please follow this structured review:
 
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
 1. Ask me for:
    - Feature/branch description
    - List of modified files

package/templates/commands/code-review.md

@@ -1,7 +1,16 @@
+---
+description: Perform a local code review before pushing changes, ensuring alignment with design docs and best practices.
+---
+
 # Local Code Review Assistant
 
 You are helping me perform a local code review **before** I push changes. Please follow this structured workflow.
 
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
 ## Step 1: Gather Context
 Ask me for:
 - Brief feature/branch description

package/templates/commands/debug.md

@@ -1,7 +1,16 @@
+---
+description: Guide me through debugging a code issue by clarifying expectations, identifying gaps, and agreeing on a fix plan before changing code.
+---
+
 # Local Debugging Assistant
 
 Help me debug an issue by clarifying expectations, identifying gaps, and agreeing on a fix plan before changing code.
 
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
 ## Step 1: Gather Context
 Ask me for:
 - Brief issue description (what is happening?)

package/templates/commands/execute-plan.md

@@ -1,7 +1,16 @@
+---
+description: Execute a feature plan interactively, guiding me through each task while referencing relevant docs and updating status.
+---
+
 # Feature Plan Execution Assistant
 
 Help me work through a feature plan one task at a time.
 
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
 ## Step 1: Gather Context
 Ask me for:
 - Feature name (kebab-case, e.g., `user-authentication`)

package/templates/commands/new-requirement.md

@@ -1,5 +1,14 @@
+---
+description: Add new feature/requirement documentation and guide me through the development workflow from requirements to testing.
+---
+
 I want to add a new feature/requirement. Please guide me through the complete development workflow:
 
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
 ## Step 1: Capture Requirement
 First, ask me:
 - What is the feature name? (e.g., "user-authentication", "payment-integration")

package/templates/commands/remember.md

@@ -0,0 +1,27 @@
+---
+description: Store reusable guidance in the knowledge memory service.
+---
+
+# Remember Knowledge
+
+When I say "remember this" or want to save a reusable rule, help me store it in the knowledge memory service.
+
+## Step 1: Capture Knowledge
+Ask me for:
+- A short, explicit title (5-12 words)
+- The detailed content (markdown, examples encouraged)
+- Optional tags (keywords like "api", "testing")
+- Optional scope (`global`, `project:<name>`, `repo:<name>`)
+
+If I'm vague, ask follow-ups to make it specific and actionable.
+
+## Step 2: Validate Quality
+- Ensure it is specific and reusable (not generic advice).
+- Avoid storing secrets or sensitive data.
+
+## Step 3: Store
+Call `memory.storeKnowledge` with title, content, tags, scope.
+If MCP tools are unavailable, use `ai-devkit memory store` instead.
+
+## Step 4: Confirm
+Summarize what was saved and offer to store more knowledge if needed.

package/templates/commands/review-design.md

@@ -1,4 +1,14 @@
+---
+description: Review the design documentation for a feature to ensure completeness and accuracy.
+---
+
 Review the design documentation in docs/ai/design/feature-{name}.md (and the project-level README if relevant). Summarize:
+
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
 - Architecture overview (ensure mermaid diagram is present and accurate)
 - Key components and their responsibilities
 - Technology choices and rationale

package/templates/commands/review-requirements.md

@@ -1,4 +1,14 @@
+---
+description: Review the requirements documentation for a feature to ensure completeness and alignment with project standards.
+---
+
 Please review `docs/ai/requirements/feature-{name}.md` and the project-level template `docs/ai/requirements/README.md` to ensure structure and content alignment. Summarize:
+
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
 - Core problem statement and affected users
 - Goals, non-goals, and success criteria
 - Primary user stories & critical flows

package/templates/commands/simplify-implementation.md

@@ -0,0 +1,153 @@
+---
+description: Analyze and simplify existing implementations to reduce complexity, improve maintainability, and enhance scalability.
+---
+
+# Simplify Implementation Assistant
+
+You are an expert engineer focused on reducing complexity and improving scalability. Help me simplify an existing implementation while maintaining or improving its functionality.
+
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
+## Step 1: Gather Context
+Ask me for:
+- Target file(s) or component(s) to simplify
+- Current pain points (hard to understand, maintain, or extend?)
+- Performance or scalability concerns
+- Any constraints (backward compatibility, API stability, deadlines)
+- Relevant design docs or requirements
+
+If available, request the current implementation:
+```bash
+# For a specific file
+cat <file_path>
+
+# For recent changes
+git diff HEAD~5 --stat
+```
+
+## Step 2: Analyze Current Complexity
+For each target file or component:
+1. **Identify complexity sources:**
+   - Deep nesting or long functions
+   - Duplicate or redundant code
+   - Unclear abstractions or leaky interfaces
+   - Tightly coupled components
+   - Over-engineering or premature optimization
+   - Magic numbers, hardcoded values, or scattered configuration
+
+2. **Measure impact:**
+   - Lines of code that could be reduced
+   - Number of dependencies that could be removed
+   - Cognitive load for future maintainers
+
+3. **Assess scalability blockers:**
+   - Single points of failure
+   - Synchronous operations that should be async
+   - Missing caching or memoization opportunities
+   - Inefficient data structures or algorithms
+
+## Step 3: Apply Readability Principles
+
+**Core Philosophy: Good code reads like a good book — naturally, from left to right, top to bottom.**
+
+When simplifying, prioritize readability over brevity. The goal is not to write the shortest code, but to write code that communicates intent clearly.
+
+### ✅ DO: Embrace Readability
+- **Linear flow:** Code should tell a story. A reader should understand the logic by reading top-to-bottom without jumping around.
+- **Explicit over implicit:** Favor clear, explicit code over clever shortcuts that require mental decoding.
+- **Meaningful names:** Variables, functions, and classes should describe their purpose without needing comments.
+- **Consistent patterns:** Use the same patterns throughout the codebase so readers build familiarity.
+- **Appropriate abstraction level:** Each function should operate at one level of abstraction.
+- **White space and grouping:** Use blank lines to separate logical blocks, like paragraphs in prose.
+
+### ❌ AVOID: Over-Optimization for Brevity
+Reducing line count is NOT the goal. These patterns often harm readability:
+
+| Anti-Pattern | Problem | Better Alternative |
+|--------------|---------|--------------------|
+| **Nested ternaries** | `a ? b ? c : d : e` is cryptic | Use explicit if/else blocks |
+| **Chained one-liners** | `x.map().filter().reduce().flat()` is hard to debug | Break into named intermediate steps |
+| **Clever bitwise tricks** | `n & 1` instead of `n % 2 === 1` obscures intent | Use readable arithmetic unless performance-critical |
+| **Overly short variable names** | `const x = getData(); const y = x.filter(z => z.a);` | Use descriptive names like `users`, `activeUsers` |
+| **Implicit returns everywhere** | Arrow functions without braces hide complexity | Add braces and explicit returns for complex logic |
+| **Magic one-liners** | Regex or reduce expressions that "do everything" | Split into documented steps |
+| **Premature DRY** | Forcing abstraction to avoid 2-3 lines of duplication | Some duplication is clearer than wrong abstraction |
+
+### 📖 The "Reading Test"
+For each simplification, ask:
+1. Can a new team member understand this in under 30 seconds?
+2. Does the code flow naturally without needing to jump to other files?
+3. Are there any "wait, what does this do?" moments?
+4. Would this code still be clear 6 months from now?
+
+If the answer is "no" to any of these, the code needs more clarity, not more optimization.
+
+## Step 4: Propose Simplifications
+For each identified issue, suggest concrete improvements:
+
+| Category | Pattern |
+|----------|---------|
+| **Extract** | Long functions → smaller, focused functions |
+| **Consolidate** | Duplicate code → shared utilities or base classes |
+| **Flatten** | Deep nesting → early returns, guard clauses |
+| **Decouple** | Tight coupling → dependency injection, interfaces |
+| **Remove** | Dead code, unused features, excessive abstractions |
+| **Replace** | Complex logic → built-in language/library features |
+| **Defer** | Premature optimization → measure-first approach |
+
+## Step 5: Prioritize Changes
+Rank suggestions by:
+1. **High impact, low risk** — Do first
+2. **High impact, higher risk** — Plan carefully
+3. **Low impact, low risk** — Quick wins if time permits
+4. **Low impact, high risk** — Skip or defer
+
+For each change, specify:
+- Before/after code snippets
+- Risk level (breaking change? needs migration?)
+- Testing requirements
+- Estimated effort
+
+## Step 6: Create Simplification Plan
+Provide a structured action plan:
+
+```
+### Simplification Summary
+- Total suggestions: [count]
+- Estimated LOC reduction: [estimate]
+- Complexity score before/after: [if measurable]
+
+### Prioritized Actions
+1. **[Component/Function Name]**
+   - Issue: ...
+   - Solution: ...
+   - Risk: Low/Medium/High
+   - Effort: S/M/L
+
+2. ... (repeat)
+
+### Recommended Order
+1. [ ] [First change - safest, unlocks others]
+2. [ ] [Second change]
+3. [ ] ...
+
+### Post-Simplification Checklist
+- [ ] Run existing tests to verify no regressions
+- [ ] Add tests for any new helper functions
+- [ ] Update documentation if interfaces changed
+- [ ] Review with team before merging larger refactors
+```
+
+## Step 7: Scalability Recommendations
+Beyond immediate simplification, suggest patterns for future scalability:
+- Modular architecture improvements
+- Caching strategies
+- Async/parallel processing opportunities
+- Configuration externalization
+- Feature flags for gradual rollouts
+
+---
+Let me know when you're ready to simplify your implementation.

package/templates/commands/update-planning.md

@@ -1,7 +1,16 @@
+---
+description: Assist in updating planning documentation to reflect current implementation progress for a feature.
+---
+
 # Planning Update Assistant
 
 Please help me reconcile the current implementation progress with our planning documentation.
 
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
 ## Step 1: Gather Context
 Ask me for:
 - Feature/branch name and brief status

package/templates/commands/writing-test.md

@@ -1,5 +1,14 @@
+---
+description: Add tests for a new feature.
+---
+
 Review `docs/ai/testing/feature-{name}.md` and ensure it mirrors the base template before writing tests.
 
+## Memory (use when helpful)
+- If you need clarification or project conventions, query `memory.searchKnowledge` with a brief task description, tags, and scope.
+- If I ask to save reusable guidance, run `/remember` (or call `memory.storeKnowledge`).
+- If MCP tools are unavailable, use `ai-devkit memory search` or `ai-devkit memory store`.
+
 ## Step 1: Gather Context
 Ask me for:
 - Feature name and branch