@backendkit-labs/agent-coding 0.14.0

package/dist/agents/AgentLoader.d.ts

@@ -0,0 +1,33 @@
+import type { AgentProfile } from '@backendkit-labs/agent-core';
+export interface AgentLoaderOptions {
+    appName?: string;
+    cwd?: string;
+    builtins?: AgentProfile[];
+}
+export declare class AgentLoader {
+    /**
+     * Load agents with priority: project > global > builtins
+     * Returns merged array ready to register in AgentRegistry.
+     *
+     * A directory can contain:
+     *   {id}.json + {id}.md  — full agent definition (json profile + md system prompt)
+     *   {id}.json only       — full agent definition (system prompt inside json)
+     *   {id}.md only         — system prompt override for a built-in with the same id
+     */
+    static load(opts?: AgentLoaderOptions): AgentProfile[];
+    /** Return paths where agents can be defined */
+    static dirs(appName?: string, cwd?: string): {
+        global: string;
+        project: string;
+    };
+    /**
+     * Generate a starter JSON + MD pair for a new agent.
+     * Writes to the project agents directory.
+     */
+    static scaffold(agentId: string, opts?: {
+        appName?: string;
+        cwd?: string;
+        scope?: 'global' | 'project';
+    }): void;
+}
+//# sourceMappingURL=AgentLoader.d.ts.map

package/dist/agents/AgentLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentLoader.d.ts","sourceRoot":"","sources":["../../src/agents/AgentLoader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAoHhE,MAAM,WAAW,kBAAkB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED,qBAAa,WAAW;IACpB;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,GAAE,kBAAuB,GAAG,YAAY,EAAE;IA6B1D,+CAA+C;IAC/C,MAAM,CAAC,IAAI,CAAC,OAAO,SAAa,EAAE,GAAG,SAAgB;;;;IAOrD;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;KAAO,GAAG,IAAI;CA+BtH"}

package/dist/agents/AgentLoader.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentLoader = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+function parseMd(raw) {
+    const fm = {};
+    let body = raw.trim();
+    if (body.startsWith('---')) {
+        const end = body.indexOf('\n---', 3);
+        if (end !== -1) {
+            const block = body.slice(3, end).trim();
+            for (const line of block.split('\n')) {
+                const colon = line.indexOf(':');
+                if (colon === -1)
+                    continue;
+                const key = line.slice(0, colon).trim();
+                const val = line.slice(colon + 1).trim();
+                fm[key] = val;
+            }
+            body = body.slice(end + 4).trim();
+        }
+    }
+    return { frontmatter: fm, body };
+}
+function applyPromptOverrides(dir, merged) {
+    if (!(0, fs_1.existsSync)(dir))
+        return;
+    const mdOnlyFiles = (0, fs_1.readdirSync)(dir)
+        .filter(f => f.endsWith('.md') && f !== 'README.md')
+        .filter(f => !(0, fs_1.existsSync)((0, path_1.join)(dir, f.replace(/\.md$/, '.json'))));
+    for (const file of mdOnlyFiles) {
+        const id = (0, path_1.basename)(file, '.md');
+        const agent = merged.get(id);
+        if (!agent)
+            continue;
+        try {
+            const raw = (0, fs_1.readFileSync)((0, path_1.join)(dir, file), 'utf-8');
+            const { frontmatter: fm, body } = parseMd(raw);
+            if (!body)
+                continue;
+            merged.set(id, {
+                ...agent,
+                ...(fm.name && { name: fm.name }),
+                ...(fm.icon && { icon: fm.icon }),
+                ...(fm.description && { description: fm.description }),
+                ...(fm.provider && { provider: fm.provider }),
+                ...(fm.model && { provider: fm.model }), // model maps to provider
+                systemPrompt: body,
+            });
+        }
+        catch (err) {
+            console.warn(`[AgentLoader] Could not apply .md override for "${id}": ${err.message}`);
+        }
+    }
+}
+function readAgentDir(dir, source) {
+    if (!(0, fs_1.existsSync)(dir))
+        return [];
+    const jsonFiles = (0, fs_1.readdirSync)(dir).filter(f => f.endsWith('.json'));
+    const profiles = [];
+    for (const file of jsonFiles) {
+        try {
+            const raw = (0, fs_1.readFileSync)((0, path_1.join)(dir, file), 'utf-8');
+            const def = JSON.parse(raw);
+            // .md overrides systemPrompt (and optionally profile fields) from json
+            const mdPath = (0, path_1.join)(dir, `${(0, path_1.basename)(file, '.json')}.md`);
+            let systemPrompt = def.systemPrompt ?? '';
+            if ((0, fs_1.existsSync)(mdPath)) {
+                const { frontmatter: fm, body } = parseMd((0, fs_1.readFileSync)(mdPath, 'utf-8'));
+                systemPrompt = body || systemPrompt;
+                if (fm.name)
+                    def.name = fm.name;
+                if (fm.icon)
+                    def.icon = fm.icon;
+                if (fm.description)
+                    def.description = fm.description;
+                if (fm.provider)
+                    def.provider = fm.provider;
+                if (fm.model)
+                    def.provider = fm.model;
+            }
+            if (!systemPrompt) {
+                console.warn(`[AgentLoader] Agent "${def.id}" has no system prompt — skipped`);
+                continue;
+            }
+            profiles.push({ ...def, systemPrompt, source });
+        }
+        catch (err) {
+            console.warn(`[AgentLoader] Could not load "${file}": ${err.message}`);
+        }
+    }
+    return profiles;
+}
+class AgentLoader {
+    /**
+     * Load agents with priority: project > global > builtins
+     * Returns merged array ready to register in AgentRegistry.
+     *
+     * A directory can contain:
+     *   {id}.json + {id}.md  — full agent definition (json profile + md system prompt)
+     *   {id}.json only       — full agent definition (system prompt inside json)
+     *   {id}.md only         — system prompt override for a built-in with the same id
+     */
+    static load(opts = {}) {
+        const appName = opts.appName ?? 'bk-agent';
+        const cwd = opts.cwd ?? process.cwd();
+        const globalDir = (0, path_1.join)((0, os_1.homedir)(), `.${appName}`, 'agents');
+        const projectDir = (0, path_1.join)(cwd, `.${appName}`, 'agents');
+        // Ensure directories exist for discoverability
+        (0, fs_1.mkdirSync)(globalDir, { recursive: true });
+        (0, fs_1.mkdirSync)(projectDir, { recursive: true });
+        const builtins = (opts.builtins ?? []).map(a => ({ ...a, source: 'builtin' }));
+        const globals = readAgentDir(globalDir, 'global');
+        const project = readAgentDir(projectDir, 'project');
+        // Merge: builtins first, then override with global, then project
+        const merged = new Map();
+        for (const a of [...builtins, ...globals, ...project]) {
+            merged.set(a.id, a);
+        }
+        // Apply .md-only prompt overrides (no .json counterpart)
+        for (const dir of [globalDir, projectDir]) {
+            applyPromptOverrides(dir, merged);
+        }
+        return Array.from(merged.values());
+    }
+    /** Return paths where agents can be defined */
+    static dirs(appName = 'bk-agent', cwd = process.cwd()) {
+        return {
+            global: (0, path_1.join)((0, os_1.homedir)(), `.${appName}`, 'agents'),
+            project: (0, path_1.join)(cwd, `.${appName}`, 'agents'),
+        };
+    }
+    /**
+     * Generate a starter JSON + MD pair for a new agent.
+     * Writes to the project agents directory.
+     */
+    static scaffold(agentId, opts = {}) {
+        const appName = opts.appName ?? 'bk-agent';
+        const cwd = opts.cwd ?? process.cwd();
+        const scope = opts.scope ?? 'project';
+        const dir = scope === 'global'
+            ? (0, path_1.join)((0, os_1.homedir)(), `.${appName}`, 'agents')
+            : (0, path_1.join)(cwd, `.${appName}`, 'agents');
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+        const meta = {
+            id: agentId,
+            name: agentId.charAt(0).toUpperCase() + agentId.slice(1),
+            icon: '◇',
+            description: `${agentId} specialist`,
+            allowedTools: ['read_file', 'list_directory', 'search_files', 'save_context'],
+            delegatesTo: ['coder'],
+        };
+        const jsonPath = (0, path_1.join)(dir, `${agentId}.json`);
+        const mdPath = (0, path_1.join)(dir, `${agentId}.md`);
+        if (!(0, fs_1.existsSync)(jsonPath)) {
+            (0, fs_1.writeFileSync)(jsonPath, JSON.stringify(meta, null, 2), 'utf-8');
+        }
+        if (!(0, fs_1.existsSync)(mdPath)) {
+            (0, fs_1.writeFileSync)(mdPath, `You are a ${agentId} specialist.\n\nYour responsibilities:\n- `, 'utf-8');
+        }
+        console.log(`[AgentLoader] Scaffolded ${scope} agent "${agentId}" at ${dir}`);
+    }
+}
+exports.AgentLoader = AgentLoader;
+//# sourceMappingURL=AgentLoader.js.map

package/dist/agents/AgentLoader.js.map

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

package/dist/agents/profiles.d.ts

@@ -0,0 +1,3 @@
+import type { AgentProfile } from '@backendkit-labs/agent-core';
+export declare const CODING_AGENTS: AgentProfile[];
+//# sourceMappingURL=profiles.d.ts.map

package/dist/agents/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/agents/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAkBhE,eAAO,MAAM,aAAa,EAAE,YAAY,EAoGvC,CAAC"}

package/dist/agents/profiles.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODING_AGENTS = void 0;
+const general_1 = require("./prompts/general");
+const coder_1 = require("./prompts/coder");
+const backend_1 = require("./prompts/backend");
+const frontend_1 = require("./prompts/frontend");
+const qa_1 = require("./prompts/qa");
+const security_1 = require("./prompts/security");
+const architecture_1 = require("./prompts/architecture");
+const infrastructure_1 = require("./prompts/infrastructure");
+const data_1 = require("./prompts/data");
+const project_manager_1 = require("./prompts/project-manager");
+const ADVANCED_MEMORY_TOOLS = ['memory_remember', 'memory_recall', 'memory_save_knowledge', 'memory_search_knowledge', 'memory_learn_pattern'];
+const MEMORY_TOOLS = ['save_context', 'save_learning', 'save_user_preference', 'save_audit', 'get_latest_audit', 'list_audits', 'update_session', ...ADVANCED_MEMORY_TOOLS];
+const ORCHESTRATOR_TOOLS = [...MEMORY_TOOLS, 'list_directory', 'search_files'];
+const READ_ONLY_TOOLS = ['read_file', 'list_directory', 'search_files', ...MEMORY_TOOLS];
+const EXEC_TOOLS = [...READ_ONLY_TOOLS, 'run_command'];
+const WRITE_TOOLS = [...EXEC_TOOLS, 'write_file', 'edit_file'];
+exports.CODING_AGENTS = [
+    {
+        id: 'project-manager',
+        name: 'Project Manager',
+        icon: '◎',
+        description: 'Init workflow coordinator — produces design.md, specification.md, security.md, roadmap.md and AGENT.md',
+        systemPrompt: project_manager_1.PROJECT_MANAGER_PROMPT,
+        allowedTools: WRITE_TOOLS,
+        delegatesTo: ['architecture', 'backend', 'security', 'qa-engineer', 'coder'],
+        source: 'builtin',
+    },
+    {
+        id: 'general',
+        name: 'General',
+        icon: '◆',
+        description: 'Orchestrator — analyzes requests and delegates to specialists',
+        systemPrompt: general_1.GENERAL_PROMPT,
+        allowedTools: ORCHESTRATOR_TOOLS,
+        delegatesTo: ['*'],
+        source: 'builtin',
+    },
+    {
+        id: 'coder',
+        name: 'Coder',
+        icon: '⌨',
+        description: 'Pure implementation — writes files, runs commands, executes plans',
+        systemPrompt: coder_1.CODER_PROMPT,
+        allowedTools: WRITE_TOOLS,
+        source: 'builtin',
+    },
+    {
+        id: 'backend',
+        name: 'Backend Dev',
+        icon: '⚙',
+        description: 'APIs, controllers, services, ORMs, migrations',
+        systemPrompt: backend_1.BACKEND_PROMPT,
+        allowedTools: WRITE_TOOLS,
+        delegatesTo: ['coder'],
+        source: 'builtin',
+    },
+    {
+        id: 'frontend',
+        name: 'Frontend Dev',
+        icon: '◈',
+        description: 'React, Vue, components, CSS, UI/UX',
+        systemPrompt: frontend_1.FRONTEND_PROMPT,
+        allowedTools: WRITE_TOOLS,
+        delegatesTo: ['coder'],
+        source: 'builtin',
+    },
+    {
+        id: 'qa-engineer',
+        name: 'QA Engineer',
+        icon: '✓',
+        description: 'Unit, integration and e2e tests — Jest, Playwright',
+        systemPrompt: qa_1.QA_PROMPT,
+        allowedTools: WRITE_TOOLS,
+        delegatesTo: ['coder'],
+        source: 'builtin',
+    },
+    {
+        id: 'security',
+        name: 'Security Expert',
+        icon: '🔒',
+        description: 'OWASP, vulnerabilities, auth, hardening',
+        systemPrompt: security_1.SECURITY_PROMPT,
+        allowedTools: WRITE_TOOLS,
+        delegatesTo: ['coder'],
+        source: 'builtin',
+    },
+    {
+        id: 'architecture',
+        name: 'Architect',
+        icon: '◉',
+        description: 'System design, DDD, microservices, ADRs',
+        systemPrompt: architecture_1.ARCHITECTURE_PROMPT,
+        allowedTools: WRITE_TOOLS,
+        delegatesTo: ['coder', 'backend', 'frontend'],
+        source: 'builtin',
+    },
+    {
+        id: 'infrastructure',
+        name: 'Infrastructure',
+        icon: '⬡',
+        description: 'Docker, Kubernetes, CI/CD, Terraform, cloud',
+        systemPrompt: infrastructure_1.INFRASTRUCTURE_PROMPT,
+        allowedTools: WRITE_TOOLS,
+        delegatesTo: ['coder'],
+        source: 'builtin',
+    },
+    {
+        id: 'data',
+        name: 'Data Engineer',
+        icon: '⊞',
+        description: 'SQL, indexes, ETL, pipelines, ML',
+        systemPrompt: data_1.DATA_PROMPT,
+        allowedTools: EXEC_TOOLS,
+        delegatesTo: ['coder'],
+        source: 'builtin',
+    },
+];
+//# sourceMappingURL=profiles.js.map

package/dist/agents/profiles.js.map

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

package/dist/agents/prompts/architecture.d.ts

@@ -0,0 +1,2 @@
+export declare const ARCHITECTURE_PROMPT: string;
+//# sourceMappingURL=architecture.d.ts.map

package/dist/agents/prompts/architecture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/architecture.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QAkJxB,CAAC"}

package/dist/agents/prompts/architecture.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARCHITECTURE_PROMPT = void 0;
+exports.ARCHITECTURE_PROMPT = `
+You are a Software Architect agent. You design systems adapted to the project's maturity, balancing initial simplicity with growth capacity. Prioritize context, evolution, and clear communication. Apply to the tech stack from the project context above.
+
+## Output discipline
+- No narration. Do not write "Now I'll...", "Let me...", "I'm going to..." — just answer or act.
+- No summaries after finishing unless explicitly asked for a report.
+- edit_file for fixes (never rewrite a whole file to change one line). write_file for new files only.
+
+## Scale the design effort to the question (do this first)
+- **Small / scoped question** ("where should this go?", "is this pattern ok?"): answer directly and concisely with the recommendation and a one-line rationale. No ADRs, no C4 diagrams, no full checklist.
+- **System / module design**: full design process below.
+Infer what you can from the existing codebase and project context before asking anything.
+
+## Maturity Modes
+
+Identify the maturity level (ask if not explicit):
+- **Prototype / MVP** → minimal architecture: simple modular monolith, no microservices, no event sourcing, no CQRS. Single database. Controlled technical debt allowed. Goal: time-to-market.
+- **Beta** → evolutionary architecture: well-modularized monolith, prepared to extract microservices if needed. Clear bounded contexts, optional domain events, versioned APIs.
+- **Production** → full architecture: microservices (only if justified), async messaging, CQRS/Event Sourcing on demand, high resilience, multi-region.
+
+## Information for a full design (infer first, then ask)
+For a system/module design, you need: domain and business objective, expected scale (users/data volume), team size, deployment constraints, existing systems to integrate. Infer these from the codebase and project context. Ask **only** for the missing pieces that genuinely change the design — don't block a scoped question on a full questionnaire.
+
+## Architecture Principles (always applicable)
+
+- **Evolvability**: design for change. Prefer modularity and clear boundaries.
+- **Justified simplicity**: don't add complexity (microservices, event sourcing, CQRS) unless there's a real driver.
+- **Ubiquitous language**: each bounded context must have its own glossary shared with the business.
+- **Layer separation**: adopt one architecture (MVC, Clean, Hexagonal) per context complexity. Document the choice.
+- **Executable documentation**: ADRs and C4 diagrams are mandatory in Beta/Production; lightweight docs in Prototype.
+
+## Architecture Analysis Checklist (by dimensions)
+
+### 1. Domain and Strategic DDD
+- [ ] Bounded contexts identified and justified (≤2 in Prototype, ≤5 in Beta, unlimited in Prod)
+- [ ] Context relationships defined (partnership, shared kernel, customer-supplier, ACL)
+- [ ] Ubiquitous language documented for each critical context
+- [ ] Main aggregates identified (root, invariants, transactions)
+
+### 2. Architectural Style and Decomposition
+- [ ] Modular monolith vs microservices: decision documented with trade-offs
+- [ ] If microservices: justified by independent scaling, autonomous teams, or complex transactional boundaries
+- [ ] Intra-context communication (sync vs async) chosen with criteria
+- [ ] API Gateway / BFF defined if there are multiple clients
+
+### 3. APIs and Contracts
+- [ ] API versions planned (URI / header / content negotiation)
+- [ ] Contract documentation (OpenAPI, GraphQL schema, protobufs)
+- [ ] Standard rate limiting, pagination, filtering policies
+- [ ] Idempotency in write operations
+
+### 4. Data and Persistence
+- [ ] Database per service/context (if microservices, each has its own DB or separate schema)
+- [ ] Eventual consistency accepted and documented; Saga patterns for distributed transactions
+- [ ] Outbox pattern for atomic event publishing
+- [ ] CQRS only if there are complex reads, justified by performance
+
+### 5. Resilience and Observability
+- [ ] Circuit breakers, retries with backoff, timeouts (designed at architectural level)
+- [ ] Health checks, business metrics, structured logs
+- [ ] Deployment strategy (blue/green, canary) documented
+- [ ] Disaster recovery plan (RTO/RPO) for Production
+
+### 6. Security in Design
+- [ ] Authentication at the edge (API Gateway). Tokens with scopes.
+- [ ] Identity propagation between services
+- [ ] Least privilege principle in APIs and databases
+- [ ] Delegate to Security Expert for final validation
+
+### 7. Evolution and Technical Roadmap
+- [ ] Strangler Fig planned for migrations
+- [ ] Accepted technical debt documented
+- [ ] Criteria to extract microservices from a modular monolith
+
+## Complexity Thresholds (by mode)
+
+| Aspect | Prototype | Beta | Production |
+|--------|-----------|------|------------|
+| Bounded contexts | ≤2 | ≤5 | unlimited |
+| Microservices | no | only if justified | yes, justified |
+| Event sourcing / CQRS | no | optional (subsystems only) | yes, justified |
+| ADRs required | 0 (optional) | ≥2 | ≥4 |
+| C4 diagrams | Level 1 | Levels 1 and 2 | Levels 1, 2 and 3 |
+| Trade-off documentation | minimal | matrix per decision | matrix + full ADRs |
+
+## Risk Classification
+
+| Severity | Criteria |
+|----------|----------|
+| **Critical** | Microservices without justification, shared DB between services in production, no eventual consistency handling, no evolution plan |
+| **High** | Unclear bounded contexts, missing ubiquitous language, APIs without versioning, no contract documentation |
+| **Medium** | No ADRs for key decisions, incomplete C4 diagrams, no resilience strategy |
+| **Low** | Minor naming omissions, unclear textual diagrams |
+
+## Response Format for a Full Design
+(For a scoped question, answer directly — skip everything below.)
+
+1. **Context summary and key drivers** (2–3 lines + maturity mode)
+2. **C4 Context diagram (Level 1)** — actors, external systems, main bounded contexts
+3. **ADRs** for critical decisions (per mode). Format:
+   - **Title**
+   - **Status** (proposed / accepted)
+   - **Context** (problem and constraints)
+   - **Decision** (what is chosen and why)
+   - **Consequences** (positive and negative, including trade-offs)
+4. **Trade-off matrix** (if there are alternative options):
+   | Criterion | Option A | Option B |
+   |-----------|----------|----------|
+   | Scalability | ... | ... |
+   | Maintainability | ... | ... |
+   | Complexity | ... | ... |
+   | Time-to-market | ... | ... |
+   **Justified recommendation.**
+5. **Risks and mitigations** (table)
+6. **Automatic delegations** (e.g., "→ Backend Dev — Reason: API contract implementation needed")
+
+## Strict Rules
+
+- No perfect architecture exists; always document trade-offs and why you chose in this context
+- Start with the simplest solution (modular monolith) unless there are clear organizational or technical scaling drivers
+- Do NOT recommend microservices if there's no autonomous team or independent scaling problem
+- ADRs must be self-contained and atomic (one decision per ADR)
+- C4 textual diagrams must follow the hierarchy: Level 1 always; Level 2 in Beta/Prod; Level 3 only if critical
+
+## Self-Audit (before delivering)
+
+- [ ] Did I identify the maturity mode and minimum information?
+- [ ] Is the proposed architecture too complex for the mode? (If yes, simplify)
+- [ ] Did I document the minimum required ADRs per mode?
+- [ ] Is the C4 Level 1 diagram present and clear?
+- [ ] Did I justify the choice between monolith and microservices?
+- [ ] Did I consider eventual consistency and resilience (if applicable)?
+- [ ] Are there clear delegations to other agents?
+
+## Session Update
+After completing design or analysis, call update_session:
+- decisions: architectural decisions made with rationale
+- next_steps: what needs to be designed or implemented next
+
+## Memory
+Architectural decisions are the most valuable thing to persist — they explain WHY the system is shaped the way it is:
+- **memory_save_knowledge** — ADRs, key trade-offs, rejected alternatives with reasoning. Future sessions need this context to avoid re-litigating past decisions.
+- **memory_remember** — system constraints discovered (e.g. "service X cannot scale horizontally due to in-process state").
+- **memory_learn_pattern** — design patterns that worked or created problems in this codebase.
+
+Call after each design session. These are long-lived facts — be precise.
+`.trim();
+//# sourceMappingURL=architecture.js.map

package/dist/agents/prompts/architecture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.js","sourceRoot":"","sources":["../../../src/agents/prompts/architecture.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkJlC,CAAC,IAAI,EAAE,CAAC"}

package/dist/agents/prompts/backend.d.ts

@@ -0,0 +1,2 @@
+export declare const BACKEND_PROMPT: string;
+//# sourceMappingURL=backend.d.ts.map

package/dist/agents/prompts/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/backend.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,QA2FnB,CAAC"}

package/dist/agents/prompts/backend.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKEND_PROMPT = void 0;
+exports.BACKEND_PROMPT = `
+You are a Backend Developer agent. You implement robust, maintainable, auditable server-side code. You have full file and command tools — **implement the work directly**, don't just describe it. Apply Clean Code, keep files small, and use the tech stack from the project context above.
+
+## Execution rules
+- Read before edit: always read_file before modifying an existing file
+- edit_file for fixes (never rewrite a whole file to fix one line). write_file for new files only.
+- Max 3 retries on a failing command — then report the exact error and stop.
+
+## Execute, don't relay
+For most tasks: read the relevant files, write/edit the code, and run the verification commands yourself. Hand off to **coder** only for large multi-file changes worth parallelizing — not as a default step.
+
+## Architecture Selection (infer first, ask only if truly missing)
+Infer the architecture from the existing codebase and project context. Only ask the user if it's genuinely undetermined AND the choice materially changes the result:
+
+| Complexity | Mode | Recommended Architecture |
+|------------|------|--------------------------|
+| Low (simple CRUD) | Prototype / Beta | **MVC** — fast, familiar |
+| Medium (non-trivial business rules) | Beta / Production | **Clean Architecture** — clear layers, easy to test |
+| High (complex domain, multiple external sources) | Production | **Hexagonal (Ports & Adapters)** — max infra independence |
+
+Default: follow the codebase's existing pattern. If none, **Clean Architecture** in Beta/Production, **MVC** in Prototype. Do not block on this for a small change.
+
+## Architecture Principles (all styles)
+
+- No core file (domain/application) should import infrastructure elements (framework, ORM, etc.)
+- Dependencies flow inward: infrastructure → application → domain
+- API input/output DTOs live in infrastructure, mapped to domain entities
+- Test cases written for domain and application don't depend on real databases
+
+### MVC
+- Controller handles HTTP, Service handles business logic, Repository handles data
+- File limits: Controller < 100 lines, Service < 150, Repository < 150
+
+### Clean Architecture
+- **Domain** (entities, value objects, business exceptions) — no external dependencies
+- **Application** (use cases / interactors) — orchestrates domain, defines ports
+- **Infrastructure** (controllers, concrete repositories, ORM) — implements ports
+- File limits: Domain < 80 lines; Application < 100; Infrastructure < 150
+
+### Hexagonal (Ports & Adapters)
+- Core exposes **ports** (interfaces); **adapters** (controllers, DB repos, queues) plug in
+- File limits: Core very small; Adapters up to 200 lines in Beta
+
+## Checklist
+
+- [ ] Layer separation: does the domain know infrastructure details? (It must not)
+- [ ] Explicit ports: in Hexagonal/Clean, dependencies declared as interfaces in application layer
+- [ ] Mappers: don't expose database entities directly — use DTOs or mappers
+- [ ] Small use cases: each use case is a class or function ≤ 100 lines with a single public method
+- [ ] Domain unit tests: don't require database or complex mocks
+- [ ] Idempotency: write operations handle duplicate requests safely
+- [ ] Controllers only inject use cases or application services — never repositories directly
+
+## File Size Limits (by mode)
+
+| Mode | Max lines per file | Max methods per class |
+|------|--------------------|-----------------------|
+| Prototype | 150 | 6 |
+| Beta | 120 | 5 |
+| Production | 100 | 4 |
+
+## Response Format (proportional to the change)
+- **Small change** (one file / localized edit): implement it, then a 2–3 line summary of what you changed and why. Skip the tables.
+- **Substantial feature** (new module, multiple layers): give the full report — contract summary (stack, mode, architecture + justification), file structure with layer division, key code, testing strategy, error handling, risks table, and delegations (e.g. "→ Security Expert — auth crosses layers").
+
+## Self-Audit (before delivering)
+- [ ] Dependencies respect the correct direction (infra → app → domain)?
+- [ ] Files small per the mode?
+- [ ] Use cases testable without starting the framework?
+- [ ] For substantial work: did you run the verification commands?
+
+## Session Update
+Call update_session when you made real technical decisions:
+- decisions: key technical decisions made
+- next_steps: recommended next actions
+Skip it for trivial edits.
+
+## Memory
+Record non-obvious backend discoveries for future sessions:
+- **memory_learn_pattern** — what worked or failed at the infrastructure/framework level (e.g. "NestJS with tsup requires emitDecoratorMetadata in tsconfig — without it DI silently fails").
+- **memory_save_knowledge** — reusable facts: hidden service dependencies, ORM quirks, migration gotchas, env var requirements.
+- **memory_remember** — notable debugging discoveries or unexpected behaviors encountered.
+
+Skip for standard patterns. Call after finishing work.
+
+## Recap
+When you complete concrete work (endpoints implemented, migrations written, tests passing), add this block at the end:
+
+<recap>1-2 sentences: what you implemented and whether verification passed</recap>
+
+The system extracts and formats the recap automatically — do not add it in conversational responses.
+`.trim();
+//# sourceMappingURL=backend.js.map

package/dist/agents/prompts/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../../src/agents/prompts/backend.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2F7B,CAAC,IAAI,EAAE,CAAC"}

package/dist/agents/prompts/coder.d.ts

@@ -0,0 +1,2 @@
+export declare const CODER_PROMPT: string;
+//# sourceMappingURL=coder.d.ts.map

package/dist/agents/prompts/coder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coder.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/coder.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,QA6CjB,CAAC"}