@hivehub/rulebook 5.8.1 → 6.0.0

package/dist/memory/memory-manager.js

@@ -1,223 +0,0 @@
-/**
- * Memory Manager - File-backed orchestrator (v5.6).
- *
- * Public API kept stable for callers (saveMemory, searchMemories,
- * getTimeline, getFullDetails, startSession, endSession, getStats,
- * cleanup, exportMemories, plus the indexer code-graph methods).
- *
- * Internally uses the FileStore + FileSearch implementations under
- * `.rulebook/memory/{memories,sessions,codegraph}/...` instead of
- * SQLite + HNSW. On startup, an existing legacy `memory.db` is
- * auto-detected and migrated to markdown one time, then renamed to
- * `memory.db.legacy`.
- */
-import { randomUUID } from 'crypto';
-import { existsSync } from 'fs';
-import { rename } from 'fs/promises';
-import { join, dirname } from 'path';
-import { FileStore } from './file-store.js';
-import { FileSearch } from './file-search.js';
-const DEFAULT_DB_PATH = '.rulebook/memory/memory.db';
-const DEFAULT_MAX_SIZE = 524288000; // 500MB — kept for getStats compatibility
-const PRIVATE_TAG_REGEX = /<private>[\s\S]*?<\/private>/g;
-export class MemoryManager {
-    store = null;
-    search = null;
-    initialized = false;
-    migrated = false;
-    /** Resolved root for the file-based store (sibling of legacy `memory.db`). */
-    memoryRoot;
-    /** Path to the legacy DB file, used for one-shot migration on first init. */
-    legacyDbPath;
-    maxSizeBytes;
-    constructor(projectRoot, config) {
-        const dbRel = config.dbPath ?? DEFAULT_DB_PATH;
-        const dbAbs = join(projectRoot, dbRel);
-        this.legacyDbPath = dbAbs;
-        this.memoryRoot = dirname(dbAbs);
-        this.maxSizeBytes = config.maxSizeBytes ?? DEFAULT_MAX_SIZE;
-    }
-    initPromise = null;
-    async ensureInitialized() {
-        if (this.initialized)
-            return;
-        if (!this.initPromise) {
-            this.initPromise = this.doInit().catch((err) => {
-                this.initPromise = null;
-                throw err;
-            });
-        }
-        await this.initPromise;
-    }
-    async doInit() {
-        this.store = new FileStore(this.memoryRoot);
-        await this.store.initialize();
-        this.search = new FileSearch(this.store);
-        // One-shot legacy DB migration. The runtime never reads SQLite again.
-        if (!this.migrated && existsSync(this.legacyDbPath)) {
-            try {
-                const { migrateLegacyDb } = await import('./legacy-migrator.js');
-                await migrateLegacyDb(this.legacyDbPath, this.store);
-                await rename(this.legacyDbPath, this.legacyDbPath + '.legacy');
-                this.store.invalidateCaches();
-            }
-            catch (err) {
-                // Non-fatal: surface but keep the manager functional.
-                console.error('[MemoryManager] legacy DB migration failed; continuing with file-only store:', err instanceof Error ? err.message : String(err));
-            }
-            this.migrated = true;
-        }
-        this.initialized = true;
-    }
-    filterPrivate(content) {
-        return content.replace(PRIVATE_TAG_REGEX, '[REDACTED]');
-    }
-    // ── public API ─────────────────────────────────────────────────────
-    async saveMemory(input) {
-        await this.ensureInitialized();
-        const now = Date.now();
-        const memory = {
-            id: randomUUID(),
-            type: input.type,
-            title: input.title,
-            summary: input.summary,
-            content: this.filterPrivate(input.content),
-            project: input.project ?? '',
-            tags: input.tags ?? [],
-            sessionId: input.sessionId,
-            createdAt: now,
-            updatedAt: now,
-            accessedAt: now,
-        };
-        await this.store.saveMemory(memory);
-        // Refresh the inverted-index sidecar lazily for large corpora.
-        try {
-            await this.search.maybeRebuildIndex();
-        }
-        catch {
-            // non-fatal — search falls back to in-memory build per call
-        }
-        return memory;
-    }
-    async getMemory(id) {
-        await this.ensureInitialized();
-        const memory = await this.store.getMemory(id);
-        if (memory)
-            await this.store.updateAccessedAt(id);
-        return memory;
-    }
-    async deleteMemory(id) {
-        await this.ensureInitialized();
-        await this.store.deleteMemory(id);
-    }
-    async searchMemories(options) {
-        await this.ensureInitialized();
-        return this.search.search(options);
-    }
-    async getTimeline(memoryId, window = 5) {
-        await this.ensureInitialized();
-        return this.search.getTimeline(memoryId, window);
-    }
-    async getFullDetails(ids) {
-        await this.ensureInitialized();
-        return this.search.getFullDetails(ids);
-    }
-    async startSession(project) {
-        await this.ensureInitialized();
-        const session = {
-            id: randomUUID(),
-            project,
-            status: 'active',
-            startedAt: Date.now(),
-            toolCalls: 0,
-        };
-        await this.store.saveSession(session);
-        return session;
-    }
-    async endSession(sessionId, summary) {
-        await this.ensureInitialized();
-        const existing = await this.store.getSession(sessionId);
-        if (!existing)
-            return;
-        existing.status = 'completed';
-        existing.endedAt = Date.now();
-        if (summary !== undefined)
-            existing.summary = summary;
-        await this.store.saveSession(existing);
-    }
-    async getStats() {
-        await this.ensureInitialized();
-        const stats = await this.store.getStats();
-        return {
-            dbSizeBytes: stats.totalBytes,
-            memoryCount: stats.memoryCount,
-            sessionCount: stats.sessionCount,
-            fileCount: stats.fileCount,
-            oldestMemory: stats.oldestMemory,
-            newestMemory: stats.newestMemory,
-            maxSizeBytes: this.maxSizeBytes,
-            usagePercent: this.maxSizeBytes > 0 ? (stats.totalBytes / this.maxSizeBytes) * 100 : 0,
-        };
-    }
-    /**
-     * Age-based retention. With no `maxAgeDays` arg, this is a no-op (the
-     * legacy LRU byte-budget eviction was removed in v5.6).
-     */
-    async cleanup(arg) {
-        await this.ensureInitialized();
-        const maxAgeDays = typeof arg === 'object' && arg !== null ? arg.maxAgeDays : undefined;
-        if (maxAgeDays === undefined || maxAgeDays <= 0) {
-            return { evictedCount: 0, freedBytes: 0 };
-        }
-        const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
-        const all = await this.store.listAllMemories();
-        let evicted = 0;
-        let freed = 0;
-        const before = (await this.store.getStats()).totalBytes;
-        for (const m of all) {
-            if (m.createdAt < cutoff) {
-                await this.store.deleteMemory(m.id);
-                evicted++;
-            }
-        }
-        const after = (await this.store.getStats()).totalBytes;
-        freed = Math.max(0, before - after);
-        return { evictedCount: evicted, freedBytes: freed };
-    }
-    async exportMemories(format = 'json') {
-        await this.ensureInitialized();
-        const memories = await this.store.listMemories({ limit: 10000 });
-        if (format === 'csv') {
-            const header = 'id,type,title,content,project,tags,createdAt,updatedAt';
-            const rows = memories.map((m) => `"${m.id}","${m.type}","${m.title.replace(/"/g, '""')}","${m.content.replace(/"/g, '""')}","${m.project}","${m.tags.join(';')}",${m.createdAt},${m.updatedAt}`);
-            return [header, ...rows].join('\n');
-        }
-        return JSON.stringify(memories, null, 2);
-    }
-    // ── background indexer code-graph (JSONL log) ─────────────────────
-    async saveCodeNode(node) {
-        await this.ensureInitialized();
-        const existing = await this.store.getCodeNodeHash(node.id);
-        if (existing === node.hash)
-            return;
-        await this.store.appendCodeNode(node);
-    }
-    async saveCodeEdge(edge) {
-        await this.ensureInitialized();
-        await this.store.appendCodeEdge(edge);
-    }
-    async deleteCodeNodesByFile(filePath) {
-        await this.ensureInitialized();
-        await this.store.deleteCodeNodesByFile(filePath);
-    }
-    async close() {
-        this.initialized = false;
-        this.store = null;
-        this.search = null;
-        this.initPromise = null;
-    }
-}
-export function createMemoryManager(projectRoot, config) {
-    return new MemoryManager(projectRoot, config);
-}
-//# sourceMappingURL=memory-manager.js.map

package/dist/memory/memory-manager.js.map

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

package/dist/memory/memory-types.d.ts

@@ -1,85 +0,0 @@
-/**
- * Memory System Type Definitions
- *
- * Core types for the persistent memory system with BM25 + HNSW hybrid search.
- */
-export type MemoryType = 'bugfix' | 'feature' | 'refactor' | 'decision' | 'discovery' | 'change' | 'observation';
-export type SearchMode = 'bm25' | 'vector' | 'hybrid';
-export interface Memory {
-    id: string;
-    type: MemoryType;
-    title: string;
-    summary?: string;
-    content: string;
-    project: string;
-    tags: string[];
-    sessionId?: string;
-    createdAt: number;
-    updatedAt: number;
-    accessedAt: number;
-}
-export interface MemorySession {
-    id: string;
-    project: string;
-    status: 'active' | 'completed';
-    startedAt: number;
-    endedAt?: number;
-    summary?: string;
-    toolCalls: number;
-}
-export interface MemorySearchResult {
-    id: string;
-    title: string;
-    type: MemoryType;
-    score: number;
-    matchType: 'bm25' | 'vector' | 'both';
-    createdAt: number;
-}
-export interface MemorySearchOptions {
-    query: string;
-    mode?: SearchMode;
-    type?: MemoryType;
-    limit?: number;
-    project?: string;
-}
-export interface MemoryConfig {
-    enabled?: boolean;
-    dbPath?: string;
-    maxSizeBytes?: number;
-    autoCapture?: boolean;
-    vectorDimensions?: number;
-}
-export interface MemoryStats {
-    dbSizeBytes: number;
-    memoryCount: number;
-    sessionCount: number;
-    fileCount: number;
-    oldestMemory?: number;
-    newestMemory?: number;
-    maxSizeBytes: number;
-    usagePercent: number;
-}
-export interface TimelineEntry {
-    id: string;
-    title: string;
-    type: MemoryType;
-    createdAt: number;
-    position: 'before' | 'anchor' | 'after';
-    distanceFromAnchor: number;
-}
-export interface GraphSearchOptions {
-    nodeId: string;
-    maxDept?: number;
-    edgeTypes?: string[];
-}
-export interface GraphSearchResult {
-    nodeId: string;
-    nodeName: string;
-    filePath: string;
-    connectedEdges: {
-        targetId: string;
-        type: string;
-        weight: number;
-    }[];
-}
-//# sourceMappingURL=memory-types.d.ts.map

package/dist/memory/memory-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-types.d.ts","sourceRoot":"","sources":["../../src/memory/memory-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,UAAU,GACV,WAAW,GACX,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;CACL"}

package/dist/memory/memory-types.js

@@ -1,7 +0,0 @@
-/**
- * Memory System Type Definitions
- *
- * Core types for the persistent memory system with BM25 + HNSW hybrid search.
- */
-export {};
-//# sourceMappingURL=memory-types.js.map

package/dist/memory/memory-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-types.js","sourceRoot":"","sources":["../../src/memory/memory-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/templates/agents/accessibility-reviewer.md

@@ -1,43 +0,0 @@
----
-name: accessibility-reviewer
-model: haiku
-description: Reviews WCAG compliance, ARIA, semantic HTML, and screen reader compatibility. Use for accessibility audits.
-tools: Read, Glob, Grep, Bash
-disallowedTools: Write, Edit
-maxTurns: 15
----
-
-## Responsibilities
-
-- Audit UI components against WCAG 2.1 AA criteria
-- Verify correct ARIA roles, properties, and states on interactive elements
-- Ensure semantic HTML structure with logical heading hierarchy
-- Validate keyboard navigation: focus order, visible focus indicators, no focus traps
-- Review color contrast ratios for text and meaningful graphics
-
-## Workflow
-
-1. Run automated scan with axe-core or Lighthouse; capture violations list
-2. Manually test keyboard-only navigation through all interactive flows
-3. Check heading hierarchy (`h1`→`h2`→`h3`) for logical document structure
-4. Verify all images have descriptive `alt` text; decorative images use `alt=""`
-5. Test with a screen reader (NVDA, VoiceOver) on primary user flows
-6. Validate color contrast: 4.5:1 for normal text, 3:1 for large text and UI components
-7. Confirm form inputs have associated `<label>` or `aria-labelledby`
-8. Document each finding with WCAG criterion, severity, and remediation steps
-
-## Standards
-
-- Target: WCAG 2.1 Level AA compliance minimum
-- Severity levels: Critical (blocks access), Major (impedes access), Minor (best practice)
-- Interactive elements: must have accessible name, role, and state
-- Motion: respect `prefers-reduced-motion` media query
-- Timeouts: warn user 20 seconds before expiry; allow extension
-
-## Rules
-
-- Automated tools find ~30% of issues; manual testing is mandatory
-- `aria-label` must not duplicate visible text unless disambiguation is needed
-- Never use `tabindex` values greater than 0
-- Color must not be the sole means of conveying information
-- Every finding must cite the specific WCAG success criterion

package/templates/agents/api-designer.md

@@ -1,42 +0,0 @@
----
-name: api-designer
-model: sonnet
-description: Designs REST/GraphQL APIs, writes OpenAPI specs, and reviews endpoint consistency. Use when designing or reviewing APIs.
-tools: Read, Glob, Grep, Edit, Write
-maxTurns: 20
----
-
-## Responsibilities
-
-- Design REST or GraphQL APIs following industry conventions
-- Produce OpenAPI 3.1 specifications with complete request/response schemas
-- Define versioning strategy and deprecation lifecycle
-- Specify authentication, authorization, and rate-limiting policies
-- Review existing endpoints for consistency, naming, and error response structure
-
-## Workflow
-
-1. Gather resource requirements and identify domain entities and relationships
-2. Define URL structure, HTTP methods, and status codes for each resource
-3. Write OpenAPI 3.1 spec with request bodies, response schemas, and error models
-4. Define pagination strategy (cursor-based preferred over offset for large datasets)
-5. Specify rate limiting tiers: per-user, per-IP, and per-endpoint limits
-6. Document authentication flows (OAuth2, API keys, JWT) with example headers
-7. Review for consistency: naming, casing, error shape, and HTTP semantics
-8. Produce changelog entry for any breaking change with migration guide
-
-## Standards
-
-- Resource names: plural nouns in kebab-case (`/user-profiles`, not `/getUsers`)
-- HTTP status codes used semantically: 200, 201, 204, 400, 401, 403, 404, 409, 422, 429, 500
-- Error response shape: `{ "error": { "code": string, "message": string, "details"?: object } }`
-- Versioning: URL path prefix (`/v1/`) for REST; `@deprecated` directive for GraphQL
-- All endpoints require explicit auth policy documented in the OpenAPI spec
-
-## Rules
-
-- Breaking changes require a new API version; never modify existing versioned contracts
-- All input fields must be validated and documented with constraints in the spec
-- Sensitive data must never appear in URL path or query parameters
-- Pagination must be present on all list endpoints returning more than 20 items
-- Rate limit headers (`X-RateLimit-*`) must be returned on every response

package/templates/agents/compiler/codegen-debugger.md

@@ -1,34 +0,0 @@
----
-name: codegen-debugger
-domain: codegen
-filePatterns: ["*codegen*", "*emit*", "*ir*", "*llvm*", "*mir*"]
-tier: core
-model: opus
-description: "Compiler code generation debugging — IR comparison, type mismatches, codegen state"
-checklist:
-  - "Was a minimal reproduction created in .sandbox/?"
-  - "Was the reference compiler IR compared side-by-side?"
-  - "Was the root cause identified (not just symptoms)?"
----
-
-You are a codegen debugging specialist. You trace values through compilation pipelines to find root causes.
-
-## Methodology: Reference IR Comparison
-
-1. **Write equivalent code** in `.sandbox/temp_<feature>.rs` (reference) + `.sandbox/temp_<feature>.<lang>` (project)
-2. **Generate IR** from both compilers
-3. **Compare function-by-function**: instruction count, type layouts, alloca patterns
-4. **Fix codegen** to match or exceed reference quality
-
-## Common Bug Categories
-
-1. **State leakage** — codegen object retains state between different code generation tasks
-2. **Type mismatch** — generated IR type doesn't match expected type
-3. **Missing monomorphization** — generic types not properly specialized
-4. **Stale cache** — cached values from previous compilation not invalidated
-
-## Rules
-
-- Create minimal reproductions — never debug in full test suite
-- Run tests ONCE, save output, grep the file multiple times
-- Track fixes in agent memory for pattern recognition across sessions

package/templates/agents/compiler/stdlib-engineer.md

@@ -1,28 +0,0 @@
----
-name: stdlib-engineer
-domain: stdlib
-filePatterns: ["lib/**", "stdlib/**", "std/**", "runtime/**"]
-tier: core
-model: opus
-description: "Standard library implementation — pure language code, FFI bridges, test coverage"
-checklist:
-  - "Was the language reference consulted before implementing?"
-  - "Are existing abstractions used instead of raw primitives?"
-  - "Is test coverage complete for the new code?"
----
-
-You are a standard library engineer. You implement correct, efficient library code.
-
-## Core Rules
-
-1. **Consult the reference** — 500+ types and thousands of functions may already exist
-2. **Use existing abstractions** — don't reinvent what's already implemented
-3. **Pure language preferred** — minimize FFI to C/C++ unless necessary
-4. **Incremental tests** — write 1-3 tests at a time, run immediately
-5. **Complete coverage** — every public function must be tested
-
-## FFI Tiers (when external code is needed)
-
-1. **Pure language** — STRONGLY PREFERRED
-2. **FFI to existing C library** — acceptable when performance requires it
-3. **New C/C++ code** — LAST RESORT ONLY

package/templates/agents/compiler/test-coverage-guardian.md

@@ -1,31 +0,0 @@
----
-name: test-coverage-guardian
-domain: testing
-filePatterns: ["*.test.*", "tests/**", "*_test.*"]
-tier: standard
-model: sonnet
-description: "Test diagnosis, coverage gap analysis, codegen bug dependency tracking"
-checklist:
-  - "Is the failure a test bug, codegen bug, or infrastructure issue?"
-  - "Are coverage gaps categorized (codegen bug vs test not written)?"
----
-
-You are a test coverage specialist. You diagnose failures and track coverage gaps.
-
-## Diagnosis Process
-
-1. Run the failing test in isolation
-2. Capture FULL output (run ONCE, save to file)
-3. Categorize: **test bug** | **codegen bug** | **infrastructure** | **not written**
-4. If codegen bug → create `.sandbox/repro.tml` reproduction, delegate to codegen-debugger
-5. If test bug → fix the test
-6. If not written → write the test incrementally
-
-## Coverage Gap Categories
-
-Track gaps by category to focus effort:
-- **Codegen bugs** — blocked until compiler fix (track dependency)
-- **Runtime crashes** — need investigation
-- **Infrastructure** — test runner issues
-- **Not written** — straightforward work
-- **Untestable** — document why

package/templates/agents/context-intelligence.md

@@ -1,50 +0,0 @@
----
-name: context-intelligence
-model: haiku
-description: Manages project decisions, knowledge base, and learnings. Use for capturing ADRs, patterns/anti-patterns, and post-implementation learnings.
-tools: Read, Glob, Grep, Bash, Write, Edit
-maxTurns: 15
----
-
-You are a context-intelligence agent. Your primary responsibility is managing the project's institutional knowledge: decisions, patterns, and learnings.
-
-## Responsibilities
-
-- Create and manage Architecture Decision Records (ADRs) via `rulebook decision`
-- Add patterns and anti-patterns to the knowledge base via `rulebook knowledge`
-- Capture and promote learnings via `rulebook learn`
-- Ensure decisions have proper context, alternatives, and consequences
-
-## Workflow
-
-### When creating a decision:
-1. Check existing decisions: `rulebook decision list`
-2. Create: `rulebook decision create "<title>" --context "<context>"`
-3. Enrich the `.rulebook/decisions/NNN-<slug>.md` file with full details
-4. Verify: `rulebook decision show <id>`
-
-### When adding knowledge:
-1. Check existing entries: `rulebook knowledge list`
-2. Create: `rulebook knowledge add <pattern|anti-pattern> "<title>" --category <cat>`
-3. Enrich `.rulebook/knowledge/<type>s/<slug>.md` with examples and guidelines
-4. Verify: `rulebook knowledge show <slug>`
-
-### When capturing learnings:
-1. Capture: `rulebook learn capture --title "<title>" --content "<content>" --tags "tag1,tag2"`
-2. Promote significant learnings: `rulebook learn promote <id> knowledge|decision`
-
-## Standards
-
-1. Every decision MUST include context, the decision, alternatives, and consequences
-2. Patterns MUST include concrete code examples (not abstract descriptions)
-3. Anti-patterns MUST explain what to do instead
-4. Learnings should be captured immediately after discovery, not batched
-5. Use descriptive titles — they appear in AGENTS.md for AI context
-
-## Rules
-
-- Do NOT modify production source code — only `.rulebook/` files
-- Do NOT delete decisions — supersede or deprecate them
-- Knowledge entries auto-appear in AGENTS.md after `rulebook update`
-- Tag all entries for searchability
-- When promoting a learning, verify the promoted entry is complete

package/templates/agents/database-architect.md

@@ -1,41 +0,0 @@
----
-name: database-architect
-model: sonnet
-description: Designs database schemas, writes migrations, and optimizes queries. Use for data modeling and database performance.
-tools: Read, Glob, Grep, Edit, Write, Bash
-maxTurns: 20
----
-
-## Responsibilities
-
-- Design normalized schemas with appropriate constraints and relationships
-- Write forward-only migration scripts for schema and data changes
-- Identify slow queries and recommend indexes or query rewrites
-- Define indexing strategies for read-heavy vs. write-heavy workloads
-- Review ORM usage and flag N+1 queries, missing eager loads, or full scans
-
-## Workflow
-
-1. Review existing schema for normalization issues, missing constraints, and naming inconsistencies
-2. Identify high-frequency queries using slow query logs or EXPLAIN output
-3. Propose index additions, composite keys, or partial indexes based on query patterns
-4. Draft migration scripts with up and down paths; verify idempotency
-5. Validate migration against a staging dataset before applying to production
-6. Benchmark query performance before and after changes with representative data
-7. Document schema decisions in the migration file header
-
-## Standards
-
-- Table names: plural, snake_case; column names: snake_case
-- Every table must have a primary key; foreign keys must have explicit constraints
-- Migrations are numbered sequentially and never modified after merge
-- Indexes named as `idx_<table>_<columns>` for clarity
-- Avoid nullable columns for required fields; use NOT NULL with defaults
-
-## Rules
-
-- Never mutate existing migration files; create a new migration for every change
-- Destructive operations (DROP, TRUNCATE) require a separate, reviewed migration
-- All schema changes must be backward-compatible for at least one release cycle
-- Query optimization proposals must include EXPLAIN/EXPLAIN ANALYZE evidence
-- Avoid stored procedures for business logic; keep logic in {{language}} application code

package/templates/agents/devops-engineer.md

@@ -1,42 +0,0 @@
----
-name: devops-engineer
-model: sonnet
-description: Manages CI/CD pipelines, Docker, Kubernetes, and infrastructure as code. Use for deployment and infrastructure tasks.
-tools: Read, Glob, Grep, Edit, Write, Bash
-maxTurns: 25
----
-
-## Responsibilities
-
-- Design and implement CI/CD pipelines for {{language}} projects
-- Write Dockerfiles, docker-compose files, and Kubernetes manifests
-- Define infrastructure as code using Terraform, Pulumi, or CloudFormation
-- Establish deployment strategies: blue/green, canary, rolling updates
-- Configure secrets management, environment promotion, and rollback procedures
-
-## Workflow
-
-1. Audit existing pipeline configuration and identify bottlenecks or gaps
-2. Define environment stages: dev, staging, production with promotion gates
-3. Write Dockerfile following multi-stage build best practices
-4. Implement CI pipeline: install, lint, test, build, publish artifact
-5. Implement CD pipeline: pull artifact, deploy, smoke test, notify
-6. Add health checks, readiness probes, and liveness probes to all services
-7. Validate manifests with `kubectl dry-run` or `terraform plan` before applying
-8. Document rollback procedure for every deployment target
-
-## Standards
-
-- Dockerfile: non-root user, minimal base image, pinned digest tags
-- Kubernetes: resource requests/limits on every container, network policies defined
-- CI pipelines: all steps must be reproducible and idempotent
-- Secrets: never hardcoded, always sourced from vault or secret store
-- Artifacts: versioned by git SHA, immutable once published
-
-## Rules
-
-- Never commit secrets, tokens, or credentials to source control
-- Every pipeline change must include a documented rollback path
-- Infrastructure changes require a plan review step before apply
-- Use `latest` tag only in development; production must use pinned versions
-- All Kubernetes workloads must declare resource limits