@vyuhlabs/dxkit 2.4.8 → 2.5.0

package/templates/CLAUDE.md.template

@@ -2,254 +2,120 @@
 
 {{PROJECT_DESCRIPTION}}
 
-## Architecture
-
-- Monorepo with make-based task runner
-- Configuration driven by `.project.yaml` (single source of truth)
-- Quality checks, testing, and formatting enforced via `make check`
-
-## Quick Reference
-
-### Setup & Diagnostics
-- `make setup` - Interactive setup for new developers
-- `make doctor` - Diagnose common setup issues
-- `make info` - Show project configuration dashboard
-- `make config` - Interactive configuration editor
-
-### Code Quality
-- `make quality` - Run all quality checks (report: tmp/reports/quality-report.md)
-- `make quality-fix` - Auto-fix issues
-- `make lint` - Lint all code
-- `make format` - Format all code
-- `make fix` - Fix all auto-fixable issues (quality-fix + format)
-- `make check` - Full pre-commit check (validate + quality + test)
-
-### Testing
-- `make test` - Run all tests (report: tmp/reports/test-report.md)
-- `make test-unit` - Fast unit tests only
-- `make test-coverage` - Detailed coverage report
-- Coverage threshold: {{COVERAGE_THRESHOLD}}%
-
-### Build & Development
-- `make build` - Build all services
-- `make clean` - Remove build artifacts
-- `make dev` - Start all services (docker-compose up)
-- `make stop` - Stop all services
-
-### Session Workflow
-- `make session-start` - Start AI-assisted development session
-- `make session-end` - End session and create checkpoint
-- `make session-commit` - Commit with quality checks
-- `make session-push` - Push to remote
-- `make session-pr` - Create PR with auto-generated content
+## How to use this file
 
-{{#IF_INFISICAL}}
-### Secrets Management
-- `make secrets-pull` - Pull secrets from Infisical to .env
-- `make secrets-show` - Show Infisical configuration (no secrets displayed)
-{{/IF_INFISICAL}}
+This file is loaded by Claude Code at the start of every session in this repo. It tells the agent what this project is, how to run common commands, and what safety rules to follow.
 
-### Configuration
-- `make lang-list` - Show enabled languages
-- `make lang-add LANG=<name>` - Enable a language
-- `make lang-remove LANG=<name>` - Disable a language
-- `make sync` - Sync .project.yaml to language config files
+The rest of `.claude/` extends this:
+- **Skills** (`.claude/skills/`) — domain context loaded on demand
+- **Commands** (`.claude/commands/`) — slash commands for common workflows
+- **Agents** (`.claude/agents/`) — specialists Claude delegates to automatically
+- **Rules** (`.claude/rules/`) — language-specific conventions
 
-### Code Generation
-- `make generate` - Generate all code
-- `make validate` - Validate generated code is up-to-date
+Run `/help` for the full list.
 
 {{#IF_PYTHON}}
 ## Python {{PYTHON_VERSION}}
 
-- **Source:** `src/` or `services/python/`
-- **Linter/Formatter:** ruff (config: `ruff.toml`, `pyproject.toml`)
-- **Type checker:** mypy
-- **Tests:** pytest (config: `pytest.ini`)
-- **Package config:** `pyproject.toml`
-- Run quality: `.project/scripts/quality/lint-python.sh`
+- **Tests**: `pytest`
+- **Lint/format**: `ruff check .` / `ruff format .`
+- **Type check**: `mypy src/`
+- **Package config**: `pyproject.toml`
 {{/IF_PYTHON}}
 
 {{#IF_GO}}
 ## Go {{GO_VERSION}}
 
-- **Source:** `services/go/`
-- **Linter:** golangci-lint (config: `.golangci.yml`)
-- **Formatter:** gofmt + goimports
-- **Tests:** `go test ./...`
-- **Module:** `go.mod`
-- Run quality: `.project/scripts/quality/lint-go.sh`
+- **Tests**: `go test ./...`
+- **Lint**: `golangci-lint run`
+- **Format**: `gofmt -w .` / `goimports -w .`
+- **Module**: `go.mod`
 {{/IF_GO}}
 
 {{#IF_NODE}}
 ## Node.js {{NODE_VERSION}}
 
-- **Package:** `package.json`, `tsconfig.json`
-- **Linter:** ESLint
-- **Formatter:** Prettier
-- **Tests:** npm test
+- **Tests**: `npm test`
+- **Build**: `npm run build`
+- **Lint/format**: `npx eslint .` / `npx prettier --write .`
+- **Package config**: `package.json`, `tsconfig.json`
 {{/IF_NODE}}
 
 {{#IF_NEXTJS}}
 ## Next.js
 
-- **Directory:** `frontend/`
-- **Stack:** App Router + TypeScript + Tailwind CSS
-- **Build:** `cd frontend && npm run build`
-- **Lint:** `cd frontend && npm run lint`
+- **Directory**: `frontend/`
+- **Dev server**: `cd frontend && npm run dev`
+- **Build**: `cd frontend && npm run build`
+- **Lint**: `cd frontend && npm run lint`
 {{/IF_NEXTJS}}
 
 {{#IF_RUST}}
 ## Rust {{RUST_VERSION}}
 
-- **Package:** `Cargo.toml`
-- **Linter:** clippy
-- **Formatter:** rustfmt
-- **Tests:** `cargo test`
+- **Tests**: `cargo test`
+- **Build**: `cargo build` / `cargo build --release`
+- **Lint**: `cargo clippy`
+- **Format**: `cargo fmt`
+- **Package**: `Cargo.toml`
 {{/IF_RUST}}
 
 {{#IF_CSHARP}}
 ## C# {{CSHARP_VERSION}}
 
-- **Source:** `src/` or `services/csharp/`
-- **Solution:** `*.sln`
-- **Project:** `*.csproj`
-- **Linter/Analyzer:** Roslyn Analyzers, StyleCop Analyzers
-- **Formatter:** `dotnet format`
-- **Tests:** `dotnet test` (xUnit)
+- **Tests**: `dotnet test`
+- **Build**: `dotnet build` / `dotnet publish -c Release`
+- **Format**: `dotnet format`
+- **Solution**: `*.sln`, projects under `*.csproj`
 {{/IF_CSHARP}}
 
 {{#IF_GCLOUD}}
 ## Google Cloud
 
-- **Auth:** `gcloud auth login` (interactive setup via `make setup`)
-- **Project:** Set in `.env` as `GOOGLE_CLOUD_PROJECT`
-- **SDK:** Installed via devcontainer post-create script
+- **Auth**: `gcloud auth login`
+- **Project**: set via `gcloud config set project <id>` or `GOOGLE_CLOUD_PROJECT` env var
 {{/IF_GCLOUD}}
 
 {{#IF_PULUMI}}
 ## Pulumi
 
-- **Auth:** `pulumi login`
-- **Workflow:** Always `pulumi preview` before `pulumi up`
-- **Secrets:** Use `pulumi config set --secret` for sensitive values
+- **Auth**: `pulumi login`
+- **Workflow**: always `pulumi preview` before `pulumi up`
+- **Secrets**: `pulumi config set --secret` for sensitive values
 {{/IF_PULUMI}}
 
-## Claude Code Integration
-
-### Skills (`.claude/skills/`)
-Domain-specific context loaded on demand. Check skill descriptions before starting work.
-- `.claude/skills/learned/references/gotchas.md` - Known project gotchas
-- `.claude/skills/learned/references/conventions.md` - Team conventions
-
-### Commands (`.claude/commands/`)
-Slash commands for common workflows. Run `/help` to list all with descriptions.
-- `/session-start` - Start dev session
-- `/session-end` - End session with checkpoint
-- `/ask <question>` - Ask about the codebase
-- `/explore-codebase` - Deep architecture exploration
-- `/onboarding` - Generate first-day developer guide
-- `/enable-agent <name>` - Activate a dormant agent
-- `/help` - List all commands and agents
-- `/quality` - Run quality checks (language-aware)
-- `/setup-hooks` - Install git pre-commit/pre-push hooks
-- `/learn` - Capture a gotcha, convention, or thing to avoid
-- `/test` - Run tests
-- `/setup-pr-review` - Set up automated PR review with Claude Code
-- `/test-gaps` - Find critical untested code paths
-- `/deps` - Map dependencies ("what breaks if I change X?")
-- `/health` - Comprehensive codebase health audit
-- `/vulnerabilities` - Scan dependencies and code for security issues
-- `/dev-report` - Developer activity and code quality report
-- `/docs` - Audit, write, or improve documentation
-- `/plan` - Generate improvement plans with KPIs from reports (fix loop)
-- `/execute-plan` - Execute a plan task by task with session management
-- `/feature` - Design and plan a new feature
-- `/build-feature` - Build a feature from a plan with tests
-- `/dashboard` - Generate HTML dashboard from all reports
-- `/stealth-mode` - Gitignore DXKit files + install smart scoped git hooks
-- `/export-pdf` - Convert markdown reports to PDF
-- `/fix-issue <number>` - Investigate and fix a GitHub issue
-
-### Rules (`.claude/rules/`)
-Language-specific conventions that activate automatically when editing matching files.
-
-### Agents
-**Active** (`.claude/agents/`) — auto-triggered when your question matches:
-- `knowledge-bot` — Answers codebase questions with file:line references (sonnet, read-only)
-- `onboarding` — Interactive onboarding buddy for new developers (sonnet, read-only)
-- `quality-reviewer` — Reviews changed code for issues before committing (sonnet)
-- `doc-writer` — Audits docs, identifies gaps, writes/improves documentation (sonnet)
-
-**Dormant** (`.claude/agents-available/`) — activate with `/enable-agent <name>`:
-- `codebase-explorer` — Deep architecture analysis, generates codebase skill (sonnet, read-only)
-- `code-reviewer` — Read-only PR review and security audit (sonnet, no write access)
-- `test-writer` — Writes tests for existing code (sonnet)
-- `test-gap-finder` — Identifies critical untested code paths (sonnet, read-only)
-- `dependency-mapper` — Maps import chains and blast radius (sonnet, read-only)
-- `health-auditor` — Comprehensive codebase health audit (sonnet, read-only)
-- `vulnerability-scanner` — Dependency and code vulnerability analysis (sonnet)
-- `dev-report` — Developer activity, quality patterns, security attribution (sonnet)
-- `dashboard-builder` — Generates HTML dashboard from all reports (sonnet)
-- `strategic-planner` — Analyzes reports, proposes KPIs, generates improvement plans (sonnet)
-- `plan-executor` — Executes plans task by task with session checkpoints (sonnet)
-- `feature-planner` — Designs new features, generates implementation plans (sonnet)
-- `feature-builder` — Implements features from plans with tests and conventions (sonnet)
-- `hooks-configurator` — Configures scoped git hooks from DXKit commands (sonnet)
-- `doc-writer` — Audits docs, identifies gaps, writes/improves documentation (sonnet)
-- `debugger` — Traces root causes systematically (sonnet, no file edits)
-
-## AI-Assisted Development Workflow
-
-```
-# 1. Start a session
-/session-start
-
-# 2. Create a feature branch
-git checkout -b feature/your-feature
-
-# 3. Ask questions as you go
-/ask How does the auth middleware work?
-
-# 4. Develop — Claude has full project context via skills
-
-# 5. Run checks before committing
-/quality
-/test
-
-# 6. Commit and push
-git add -A && git commit -m "feat: your feature"
-git push -u origin feature/your-feature
-
-# 7. End session (creates checkpoint + evolves skills)
-/session-end
-```
-
-## Security
-
-**Critical rules — never violate these:**
+## Common slash commands
+
+- `/health` — full codebase health audit (6 dimensions)
+- `/vulnerabilities` — scan dependencies + code for security issues
+- `/test-gaps` — find critical untested code paths
+- `/quality` — code quality + slop analysis
+- `/dev-report` — team activity from git history
+- `/ask <question>` — natural-language Q&A against the codebase
+- `/explore-codebase` — deep architecture exploration (run once on a new repo)
+- `/setup-hooks` — install git pre-commit/pre-push hooks
+- `/learn` — capture a gotcha or convention from the current conversation
+
+Run `/help` for the full list of commands and agents.
+
+## Security rules — never violate
 
 1. **Never output, log, or commit secrets** — no API keys, tokens, passwords, or credentials in code, commits, checkpoints, or skill files
-2. **Never read `.env` directly** — use `make secrets-show` (which masks values) to check configuration
+2. **Never read `.env` directly** — if you need to confirm a value exists, grep for the variable name only
 3. **Never pass secrets as CLI arguments** — they appear in process lists and shell history
 4. **Never include secrets in build args or Dockerfiles**
-5. **Sensitive files are gitignored:** `.env`, `.env.*`, `.env.secrets`, `.claude/settings.local.json`
-6. **Before committing:** verify no secrets in staged files (`git diff --cached`)
+5. **Sensitive files are gitignored**: `.env`, `.env.*`, `.env.secrets`, `.claude/settings.local.json`
+6. **Before committing**: verify no secrets in staged files (`git diff --cached`)
 {{#IF_INFISICAL}}
-7. **Infisical tokens:** never output `INFISICAL_TOKEN` values; use `make secrets-show` to verify config
+7. **Infisical tokens**: never output `INFISICAL_TOKEN` values
 {{/IF_INFISICAL}}
 {{#IF_GCLOUD}}
-8. **GCP credentials:** never output `gcloud auth print-access-token` or service account JSON keys
+8. **GCP credentials**: never output `gcloud auth print-access-token` or service account JSON keys
 {{/IF_GCLOUD}}
 
 ## Conventions
 
-- Run quality checks before committing (`/quality` or `make quality`)
-- Use `/session-start` to begin work, `/session-end` to checkpoint
-- All code changes should pass quality + test checks
-{{#IF_PRECOMMIT}}
-- Pre-commit hooks run automatically on `git commit`
-{{/IF_PRECOMMIT}}
-- Keep session checkpoints in `.ai/sessions/<developer>/<date>/`
-- Skills evolve over time — gotchas and conventions are captured during `/session-end`
-- Check `/help` for all available commands and agents
+- Run `/quality` and `/test` before committing
+- For changes to risky areas (auth, payments, data mutations), write tests first
+- Capture surprising behaviors via `/learn` so the next session inherits them
+- Check `/help` for available commands and agents

package/dist/project-yaml.d.ts

@@ -1,13 +0,0 @@
-import { ResolvedConfig } from './types';
-/** Check if .project.yaml exists in the given directory. */
-export declare function hasProjectYaml(cwd: string): boolean;
-/**
- * Read .project.yaml and build a ResolvedConfig from it.
- * This is the primary config source when create-devstack has already
- * written the file — dxkit skips detect() and prompts in this case.
- *
- * Returns null if the file is malformed or missing required fields
- * (project.name). The caller should fall back to detect() + prompts.
- */
-export declare function readProjectYaml(cwd: string): ResolvedConfig | null;
-//# sourceMappingURL=project-yaml.d.ts.map

package/dist/project-yaml.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"project-yaml.d.ts","sourceRoot":"","sources":["../src/project-yaml.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAiB,MAAM,SAAS,CAAC;AA4CxD,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAqFlE"}

package/dist/project-yaml.js

@@ -1,188 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasProjectYaml = hasProjectYaml;
-exports.readProjectYaml = readProjectYaml;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const constants_1 = require("./constants");
-const languages_1 = require("./languages");
-/** Check if .project.yaml exists in the given directory. */
-function hasProjectYaml(cwd) {
-    return fs.existsSync(path.join(cwd, '.project.yaml'));
-}
-/**
- * Read .project.yaml and build a ResolvedConfig from it.
- * This is the primary config source when create-devstack has already
- * written the file — dxkit skips detect() and prompts in this case.
- *
- * Returns null if the file is malformed or missing required fields
- * (project.name). The caller should fall back to detect() + prompts.
- */
-function readProjectYaml(cwd) {
-    const filePath = path.join(cwd, '.project.yaml');
-    let raw;
-    try {
-        raw = fs.readFileSync(filePath, 'utf-8');
-    }
-    catch {
-        return null;
-    }
-    let yaml;
-    try {
-        yaml = parseSimpleYaml(raw);
-    }
-    catch {
-        return null;
-    }
-    // project.name is required
-    if (!yaml.project?.name) {
-        return null;
-    }
-    const langs = yaml.languages ?? {};
-    const infra = yaml.infrastructure ?? {};
-    const tools = yaml.tools ?? {};
-    const langEnabled = (name) => langs[name]?.enabled ?? false;
-    const infraEnabled = (name) => infra[name]?.enabled ?? false;
-    // Find coverage from first enabled language with quality settings
-    let coverage = constants_1.DEFAULT_COVERAGE;
-    for (const lang of Object.values(langs)) {
-        if (lang?.enabled && lang.quality?.coverage) {
-            coverage = String(lang.quality.coverage);
-            break;
-        }
-    }
-    // YAML uses legacy keys `node` / `nextjs` for backwards compat with
-    // existing `.project.yaml` files. After 10f.4, `DetectedStack.languages`
-    // is keyed on `LanguageId`. Iterate the registry so adding a new pack
-    // auto-extends YAML reading — by default each pack maps to its
-    // matching `langEnabled(<id>)`. The typescript pack is the only
-    // special case: yaml's `node` OR `nextjs` activates it.
-    const VERSION_KEYS = ['python', 'go', 'node', 'rust', 'csharp'];
-    const yamlNextjs = langEnabled('nextjs');
-    const detected = {
-        languages: Object.fromEntries(languages_1.LANGUAGES.map((lang) => {
-            if (lang.id === 'typescript')
-                return [lang.id, langEnabled('node') || yamlNextjs];
-            return [lang.id, langEnabled(lang.id)];
-        })),
-        infrastructure: {
-            docker: tools.docker ?? true,
-            postgres: infraEnabled('postgres'),
-            redis: infraEnabled('redis'),
-        },
-        tools: {
-            gcloud: tools.gcloud ?? false,
-            pulumi: tools.pulumi ?? false,
-            infisical: tools.infisical ?? false,
-            ghCli: tools.github_cli ?? true,
-        },
-        projectName: yaml.project.name,
-        projectDescription: yaml.project.description ?? '',
-        versions: Object.fromEntries(VERSION_KEYS.map((k) => [k, langs[k]?.version ?? constants_1.DEFAULT_VERSIONS[k]])),
-        // 10f.4: nextjs moved out of `languages` and is now exclusively the
-        // framework signal. Preserved here so downstream consumers (generator,
-        // buildConditions) continue to see `framework === 'nextjs'`.
-        framework: yamlNextjs ? 'nextjs' : undefined,
-        requiredTools: [],
-    };
-    return {
-        ...detected,
-        coverageThreshold: coverage,
-        precommit: tools.precommit ?? true,
-        qualityChecks: true,
-        aiSessions: true,
-        aiPrompts: true,
-        claudeCode: tools.claude_code ?? true,
-    };
-}
-/**
- * Minimal YAML parser for .project.yaml.
- * Handles the specific structure we expect — nested objects with scalar values.
- * Avoids adding a `yaml` npm dependency to dxkit (which has zero runtime deps).
- */
-function parseSimpleYaml(raw) {
-    const lines = raw.split('\n');
-    const result = {};
-    const stack = [
-        { indent: -1, obj: result },
-    ];
-    for (const line of lines) {
-        // Skip empty lines and comments
-        if (!line.trim() || line.trim().startsWith('#'))
-            continue;
-        const indent = line.search(/\S/);
-        const trimmed = line.trim();
-        // Pop stack to find parent
-        while (stack.length > 1 && stack[stack.length - 1].indent >= indent) {
-            stack.pop();
-        }
-        const parent = stack[stack.length - 1].obj;
-        const colonIdx = trimmed.indexOf(':');
-        if (colonIdx === -1)
-            continue;
-        const key = trimmed.slice(0, colonIdx).trim();
-        const valueStr = trimmed.slice(colonIdx + 1).trim();
-        if (valueStr === '' || valueStr === '{}') {
-            // Nested object (or empty object)
-            const child = {};
-            parent[key] = child;
-            if (valueStr !== '{}') {
-                stack.push({ indent, obj: child });
-            }
-        }
-        else {
-            // Scalar value
-            parent[key] = parseScalar(valueStr);
-        }
-    }
-    return result;
-}
-function parseScalar(value) {
-    // Remove surrounding quotes
-    if ((value.startsWith("'") && value.endsWith("'")) ||
-        (value.startsWith('"') && value.endsWith('"'))) {
-        return value.slice(1, -1);
-    }
-    if (value === 'true')
-        return true;
-    if (value === 'false')
-        return false;
-    const num = Number(value);
-    if (!isNaN(num) && value !== '')
-        return num;
-    return value;
-}
-//# sourceMappingURL=project-yaml.js.map

package/dist/project-yaml.js.map

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

package/templates/.ai/README.md

@@ -1,117 +0,0 @@
-# AI-Assisted Development Sessions
-
-This directory contains session checkpoints, templates, and prompts for AI-assisted development.
-
-## Directory Structure
-
-```
-.ai/
-├── README.md                          # This file
-├── sessions/                          # Session checkpoints by developer
-│   ├── john-doe/
-│   │   ├── 2025-10-05/
-│   │   │   ├── session-1.md
-│   │   │   └── session-2.md
-│   │   └── 2025-10-06/
-│   │       └── session-1.md
-│   └── jane-smith/
-│       └── 2025-10-05/
-│           └── session-1.md
-├── templates/
-│   └── session-checkpoint-template.md # Checkpoint template
-└── prompts/
-    ├── session-start.md               # Starting session prompt
-    ├── step-by-step.md                # Development flow prompt
-    └── session-end.md                 # Ending session prompt
-```
-
-## Quick Start
-
-### Starting a New Session
-
-```bash
-make ai-start
-```
-
-This will:
-- Show your last checkpoint (if exists)
-- Display the session start prompt
-- Help you plan the session with AI
-
-### During Development
-
-```bash
-make ai-step
-```
-
-Shows the step-by-step development guide for AI-assisted coding.
-
-### Ending a Session
-
-```bash
-make ai-checkpoint
-```
-
-This will:
-- Show the session end prompt
-- Tell AI where to create the checkpoint file
-- Provide the template location
-
-### View Session History
-
-```bash
-make ai-history
-```
-
-Shows recent sessions for you and other developers.
-
-## Session Workflow
-
-1. **Start:** `make ai-start` → Plan with AI
-2. **Develop:** Code step-by-step, use `make ai-step` as reference
-3. **End:** `make ai-checkpoint` → AI creates checkpoint
-4. **Commit:** Include checkpoint in commit message
-
-## Session Naming Convention
-
-```
-.ai/sessions/{developer-name}/{YYYY-MM-DD}/session-{N}.md
-```
-
-- `developer-name`: From `git config user.name` (lowercase, hyphens)
-- `YYYY-MM-DD`: Dated folder for that day's sessions
-- `N`: Session number for that day
-
-## What Goes in a Checkpoint?
-
-A good checkpoint includes:
-
-- **Session goal** - What we set out to accomplish
-- **Accomplishments** - Specific items completed
-- **Files changed** - All created/modified files
-- **Key decisions** - Why we chose this approach
-- **Implementation details** - How it works
-- **Testing status** - What's tested and passing
-- **Next steps** - Clear actions for next session
-- **AI context** - Detailed context for continuing
-
-See [session-checkpoint-template.md](templates/session-checkpoint-template.md) for full structure.
-
-## Best Practices
-
-✅ **Do:**
-- Create checkpoints at end of every session
-- Be specific and detailed
-- Document key decisions and reasoning
-- Provide clear next steps
-- Include enough context for AI to continue
-
-❌ **Don't:**
-- Skip checkpoint creation
-- Be vague ("worked on stuff")
-- Forget to list all file changes
-- Leave out decision rationale
-
----
-
-**Remember:** Good checkpoints enable seamless collaboration between developers and AI agents.

package/templates/.ai/prompts/execution-prompt.md

@@ -1,9 +0,0 @@
-Great plan! Let's proceed step by step.
-
-Before implementing each component:
-1. Tell me what you're about to do
-2. Explain WHY we're doing it this way
-3. Explain HOW it will work
-4. Then implement it
-
-Let's start with {FIRST_COMPONENT_FROM_PLAN}.