kyro-ai 3.2.0

package/dist/cli/install-plan.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInstallPlan = buildInstallPlan;
+const constants_1 = require("./constants");
+const registry_1 = require("./adapters/registry");
+const fs_1 = require("./fs");
+const help_1 = require("./help");
+const state_1 = require("./state");
+function buildInstallPlan(agents, scope) {
+    const now = new Date().toISOString();
+    const packageVersion = (0, help_1.readPackageVersion)();
+    const state = mergeProjectState(agents, scope, now);
+    const manifestAgents = state.installedAdapters.map((adapter) => adapter.agent);
+    const adapters = state.installedAdapters;
+    const managedFiles = buildManagedFiles(manifestAgents);
+    const managedBlocks = buildManagedBlocks(manifestAgents);
+    const manifest = {
+        schemaVersion: 1,
+        packageName: constants_1.WORKFLOW_NAME,
+        packageVersion,
+        installedAt: now,
+        installScope: scope,
+        managedFiles,
+        managedBlocks,
+        adapters,
+    };
+    const plan = [
+        { action: 'mkdir', path: constants_1.ARTIFACT_ROOT },
+        { action: 'write', path: constants_1.KYRO_STATE_PATH, content: `${JSON.stringify(state, null, 2)}\n` },
+        { action: 'mkdir', path: constants_1.KYRO_ROOT },
+        { action: 'write', path: constants_1.KYRO_MANIFEST_PATH, content: `${JSON.stringify(manifest, null, 2)}\n` },
+        { action: 'write', path: `${constants_1.KYRO_ROOT}/KYRO.md`, content: buildKyroBootstrap() },
+    ];
+    (0, fs_1.addCopyDirectoryPlan)(plan, 'agents', `${constants_1.KYRO_CORE_ROOT}/agents`);
+    (0, fs_1.addCopyDirectoryPlan)(plan, 'commands', constants_1.KYRO_COMMANDS_ROOT);
+    (0, fs_1.addCopyDirectoryPlan)(plan, 'skills', constants_1.KYRO_SKILLS_ROOT);
+    (0, fs_1.addCopyFilePlan)(plan, 'config.json', `${constants_1.KYRO_CORE_ROOT}/config.json`);
+    (0, fs_1.addCopyFilePlan)(plan, 'WORKFLOW.yaml', `${constants_1.KYRO_CORE_ROOT}/WORKFLOW.yaml`);
+    for (const adapter of (0, registry_1.getInstalledAdapterDefinitions)(manifestAgents)) {
+        adapter.buildProjection(plan);
+    }
+    return plan;
+}
+function mergeProjectState(agents, scope, installedAt) {
+    const existing = (0, state_1.readProjectState)();
+    const base = existing ?? {
+        schemaVersion: 1,
+        artifactRoot: constants_1.ARTIFACT_ROOT,
+        scopes: [],
+        activeScope: null,
+        installedAdapters: [],
+    };
+    const adaptersByAgent = new Map();
+    for (const adapter of base.installedAdapters) {
+        adaptersByAgent.set(adapter.agent, adapter);
+    }
+    for (const agent of agents) {
+        adaptersByAgent.set(agent, (0, registry_1.getAdapterDefinition)(agent).buildInstalledAdapter(scope, installedAt));
+    }
+    return {
+        schemaVersion: 1,
+        artifactRoot: constants_1.ARTIFACT_ROOT,
+        scopes: [...base.scopes],
+        activeScope: base.activeScope,
+        installedAdapters: [...adaptersByAgent.values()].sort((a, b) => a.agent.localeCompare(b.agent)),
+    };
+}
+function buildManagedFiles(agents) {
+    const files = [
+        constants_1.KYRO_MANIFEST_PATH,
+        `${constants_1.KYRO_ROOT}/KYRO.md`,
+        `${constants_1.KYRO_CORE_ROOT}/config.json`,
+        `${constants_1.KYRO_CORE_ROOT}/WORKFLOW.yaml`,
+    ];
+    files.push(...(0, fs_1.listRelativeFiles)('agents').map((file) => `${constants_1.KYRO_CORE_ROOT}/agents/${file}`));
+    files.push(...(0, fs_1.listRelativeFiles)('commands').map((file) => `${constants_1.KYRO_COMMANDS_ROOT}/${file}`));
+    files.push(...(0, fs_1.listRelativeFiles)('skills').map((file) => `${constants_1.KYRO_SKILLS_ROOT}/${file}`));
+    for (const adapter of (0, registry_1.getInstalledAdapterDefinitions)(agents)) {
+        files.push(...adapter.buildManagedFiles());
+    }
+    return [...new Set(files)].sort();
+}
+function buildKyroBootstrap() {
+    return `# Kyro Workspace Harness\n\nThis directory is managed by Kyro.\n\n- Core assets: \`${constants_1.KYRO_CORE_ROOT}/\`\n- Commands: \`${constants_1.KYRO_COMMANDS_ROOT}/\`\n- Skills: \`${constants_1.KYRO_SKILLS_ROOT}/\`\n- Project state: \`${constants_1.KYRO_STATE_PATH}\`\n\nUse installed agent commands/skills when available. Do not require users to invoke Kyro workflows through natural-language fallbacks unless the host agent has no native command or skill mechanism.\n`;
+}
+function buildManagedBlocks(agents) {
+    const blocks = [];
+    for (const adapter of (0, registry_1.getInstalledAdapterDefinitions)(agents)) {
+        blocks.push(...adapter.buildManagedBlocks());
+    }
+    return [...new Set(blocks)].sort();
+}
+//# sourceMappingURL=install-plan.js.map

package/dist/cli/install-plan.js.map

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

package/dist/cli/options.d.ts

@@ -0,0 +1,8 @@
+import type { Agent, CliOptions, InstallScope } from './types';
+export declare function parseOptions(args: string[]): CliOptions;
+export declare function parseAgent(value: string): Agent;
+export declare function parseScope(value: string): InstallScope;
+export declare function uniqueAgents(agents: Agent[]): Agent[];
+export declare function assertWorkspaceScope(scope: InstallScope): void;
+export declare function assertInstallableAgents(agents: Agent[]): void;
+//# sourceMappingURL=options.d.ts.map

package/dist/cli/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/cli/options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE/D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA2CvD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAO/C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAItD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAErD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAI9D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAK7D"}

package/dist/cli/options.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOptions = parseOptions;
+exports.parseAgent = parseAgent;
+exports.parseScope = parseScope;
+exports.uniqueAgents = uniqueAgents;
+exports.assertWorkspaceScope = assertWorkspaceScope;
+exports.assertInstallableAgents = assertInstallableAgents;
+const constants_1 = require("./constants");
+const registry_1 = require("./adapters/registry");
+function parseOptions(args) {
+    const agents = [];
+    let scope = constants_1.SCOPE.WORKSPACE;
+    let dryRun = false;
+    let yes = false;
+    let help = false;
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === '--dry-run') {
+            dryRun = true;
+        }
+        else if (arg === '--yes' || arg === '-y') {
+            yes = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            help = true;
+        }
+        else if (arg === '--agent' || arg === '--agents') {
+            const value = args[i + 1];
+            if (!value)
+                throw new Error(`${arg} requires a value`);
+            agents.push(...parseAgents(value));
+            i += 1;
+        }
+        else if (arg.startsWith('--agent=')) {
+            agents.push(...parseAgents(arg.slice('--agent='.length)));
+        }
+        else if (arg.startsWith('--agents=')) {
+            agents.push(...parseAgents(arg.slice('--agents='.length)));
+        }
+        else if (arg === '--scope') {
+            const value = args[i + 1];
+            if (!value)
+                throw new Error('--scope requires a value');
+            scope = parseScope(value);
+            i += 1;
+        }
+        else if (arg.startsWith('--scope=')) {
+            scope = parseScope(arg.slice('--scope='.length));
+        }
+        else {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+    }
+    return {
+        agents: uniqueAgents(agents.length > 0 ? agents : [constants_1.AGENT.OPENCODE]),
+        scope,
+        dryRun,
+        yes,
+        help,
+    };
+}
+function parseAgent(value) {
+    const normalized = value.toLowerCase();
+    if (normalized === 'opencode')
+        return constants_1.AGENT.OPENCODE;
+    if (normalized === 'claude' || normalized === 'claude-code')
+        return constants_1.AGENT.CLAUDE;
+    if (normalized === 'codex')
+        return constants_1.AGENT.CODEX;
+    if (normalized === 'cursor')
+        return constants_1.AGENT.CURSOR;
+    throw new Error(`Unsupported agent: ${value}. Supported now: ${(0, registry_1.getInstallableAdapters)().map((adapter) => adapter.agent).join(', ')}. Use root AGENTS.md for cross-agent instructions; no generic adapter is installed.`);
+}
+function parseScope(value) {
+    if (value === constants_1.SCOPE.WORKSPACE)
+        return constants_1.SCOPE.WORKSPACE;
+    if (value === constants_1.SCOPE.GLOBAL)
+        return constants_1.SCOPE.GLOBAL;
+    throw new Error(`Unsupported scope: ${value}. Use workspace or global.`);
+}
+function uniqueAgents(agents) {
+    return [...new Set(agents)];
+}
+function assertWorkspaceScope(scope) {
+    if (scope !== constants_1.SCOPE.WORKSPACE) {
+        throw new Error('Only --scope workspace is implemented in Plan B Sprint 1. Global install is planned but not active yet.');
+    }
+}
+function assertInstallableAgents(agents) {
+    const unsupported = agents.filter((agent) => (0, registry_1.getAdapterDefinition)(agent).status !== 'implemented');
+    if (unsupported.length > 0) {
+        throw new Error(`Agent adapter not implemented yet: ${unsupported.join(', ')}. Implemented now: ${(0, registry_1.getInstallableAdapters)().map((adapter) => adapter.agent).join(', ')}. Claude plugin remains first-class through .claude-plugin/.`);
+    }
+}
+function parseAgents(value) {
+    return value.split(',').map((item) => parseAgent(item.trim())).filter(Boolean);
+}
+//# sourceMappingURL=options.js.map

package/dist/cli/options.js.map

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

package/dist/cli/state.d.ts

@@ -0,0 +1,4 @@
+import type { KyroManifest, KyroProjectState } from './types';
+export declare function readProjectState(): KyroProjectState | null;
+export declare function readManifest(): KyroManifest | null;
+//# sourceMappingURL=state.d.ts.map

package/dist/cli/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/cli/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE9D,wBAAgB,gBAAgB,IAAI,gBAAgB,GAAG,IAAI,CAE1D;AAED,wBAAgB,YAAY,IAAI,YAAY,GAAG,IAAI,CAElD"}

package/dist/cli/state.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readProjectState = readProjectState;
+exports.readManifest = readManifest;
+const constants_1 = require("./constants");
+const fs_1 = require("./fs");
+function readProjectState() {
+    return (0, fs_1.readJsonFromWorkspace)(constants_1.KYRO_STATE_PATH);
+}
+function readManifest() {
+    return (0, fs_1.readJsonFromWorkspace)(constants_1.KYRO_MANIFEST_PATH);
+}
+//# sourceMappingURL=state.js.map

package/dist/cli/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/cli/state.ts"],"names":[],"mappings":";;AAIA,4CAEC;AAED,oCAEC;AAVD,2CAAkE;AAClE,6BAA6C;AAG7C,SAAgB,gBAAgB;IAC9B,OAAO,IAAA,0BAAqB,EAAmB,2BAAe,CAAC,CAAC;AAClE,CAAC;AAED,SAAgB,YAAY;IAC1B,OAAO,IAAA,0BAAqB,EAAe,8BAAkB,CAAC,CAAC;AACjE,CAAC"}

package/dist/cli/types.d.ts

@@ -0,0 +1,50 @@
+import type { AGENT, COMMAND_NAMES, SCOPE } from './constants';
+export type Agent = (typeof AGENT)[keyof typeof AGENT];
+export type InstallScope = (typeof SCOPE)[keyof typeof SCOPE];
+export type KyroCommandName = (typeof COMMAND_NAMES)[number];
+export interface KyroInstalledAdapter {
+    agent: Agent;
+    scope: InstallScope;
+    installedAt: string;
+    corePath: string;
+    commandsPath?: string;
+    skillsPath?: string;
+}
+export interface KyroProjectState {
+    schemaVersion: 1;
+    artifactRoot: string;
+    scopes: string[];
+    activeScope: string | null;
+    installedAdapters: KyroInstalledAdapter[];
+}
+export interface KyroManifest {
+    schemaVersion: 1;
+    packageName: string;
+    packageVersion: string;
+    installedAt: string;
+    installScope: InstallScope;
+    managedFiles: string[];
+    managedBlocks: string[];
+    adapters: KyroInstalledAdapter[];
+}
+export interface CliOptions {
+    agents: Agent[];
+    scope: InstallScope;
+    dryRun: boolean;
+    yes: boolean;
+    help: boolean;
+}
+export interface OperationPlan {
+    action: 'write' | 'copy' | 'mkdir' | 'remove' | 'upsert-block' | 'remove-block';
+    path: string;
+    source?: string;
+    content?: string;
+    blockName?: string;
+}
+export interface CheckResult {
+    status: 'pass' | 'warn' | 'fail';
+    name: string;
+    detail: string;
+    remedy?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,CAAC,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,GAAG,cAAc,CAAC;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/cli/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const app_1 = require("./cli/app");
+void (0, app_1.runCli)().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`ERROR: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AACA,mCAAmC;AAEnC,KAAK,IAAA,YAAM,GAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACrC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export declare const KYRO_WORKFLOW: {
+    readonly name: "kyro-ai";
+    readonly stateModel: "markdown";
+    readonly artifactRoot: ".agents/kyro/scopes";
+    readonly commands: readonly ["forge", "status", "wrap-up"];
+    readonly agents: readonly ["orchestrator"];
+    readonly skills: readonly ["sprint-forge", "qa-review"];
+};
+export type KyroWorkflow = typeof KYRO_WORKFLOW;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;;;;;;CAOhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KYRO_WORKFLOW = void 0;
+exports.KYRO_WORKFLOW = {
+    name: 'kyro-ai',
+    stateModel: 'markdown',
+    artifactRoot: '.agents/kyro/scopes',
+    commands: ['forge', 'status', 'wrap-up'],
+    agents: ['orchestrator'],
+    skills: ['sprint-forge', 'qa-review']
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG;IAC3B,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,qBAAqB;IACnC,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;IACxC,MAAM,EAAE,CAAC,cAAc,CAAC;IACxB,MAAM,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;CAC7B,CAAC"}

package/docs/HOW-TO-USE-CODEX.md

@@ -0,0 +1,82 @@
+# Codex Adapter Guide
+
+This guide describes manual Kyro usage with Codex-style agents. Native command or skill registration depends on the specific Codex environment; Kyro compatibility comes from referencing portable markdown files.
+
+---
+
+## Setup
+
+```bash
+mkdir -p .skills .agents .agents/kyro/scopes
+
+cp -r kyro-ai/skills/sprint-forge .skills/
+cp -r kyro-ai/skills/qa-review .skills/
+cp kyro-ai/agents/orchestrator.md .agents/
+```
+
+---
+
+## Onboarding Prompt
+
+```text
+Use Kyro for this project.
+
+Read:
+- .agents/orchestrator.md
+- .skills/sprint-forge/SKILL.md
+- .skills/qa-review/SKILL.md
+
+Persist workflow artifacts under .agents/kyro/scopes/{scope}/.
+If slash commands are unavailable, use these intents:
+- forge = analyze/plan/execute/review/close
+- status = read artifacts and report progress/debt
+- wrap-up = close the session and update re-entry prompts
+```
+
+---
+
+## Common Flows
+
+### Review
+
+```text
+@file .skills/qa-review/SKILL.md
+
+Review this change and return APPROVED, APPROVED WITH NOTES,
+CHANGES REQUIRED, or REJECTED.
+
+Context:
+- Scope: {scope}
+- Sprint artifacts: .agents/kyro/scopes/{scope}/
+```
+
+### Forge
+
+```text
+@file .agents/orchestrator.md
+@file .skills/sprint-forge/SKILL.md
+@file .skills/qa-review/SKILL.md
+
+Run the forge intent for {scope}.
+Use .agents/kyro/scopes/{scope}/ for findings, roadmap, phases,
+handoffs, and re-entry prompts.
+```
+
+### Status
+
+```text
+@file .skills/sprint-forge/SKILL.md
+
+Run the status intent for .agents/kyro/scopes/{scope}/.
+Report sprint progress, open debt, aged debt, blockers, and next action.
+```
+
+---
+
+## Limitations
+
+- Codex environments may not register Kyro slash commands automatically.
+- Artifact persistence depends on the agent writing files correctly.
+- Learned rules work through `.agents/kyro/scopes/rules.md`, not through a runtime service.
+
+For generic setup and Cursor/OpenCode notes, see [Agent Adapters](agent-adapters.md).

package/docs/HOW-TO-USE-OPENCODE.md

@@ -0,0 +1,93 @@
+# OpenCode Adapter Guide
+
+This guide describes manual Kyro usage with OpenCode-style agents. Native command or skill registration depends on the host environment; Kyro compatibility comes from referencing portable markdown files.
+
+---
+
+## Setup
+
+```bash
+mkdir -p .skills .agents .agents/kyro/scopes
+
+cp -r kyro-ai/skills/sprint-forge .skills/
+cp -r kyro-ai/skills/qa-review .skills/
+cp kyro-ai/agents/orchestrator.md .agents/
+```
+
+Recommended project structure:
+
+```text
+your-project/
+├── .agents/
+│   ├── orchestrator.md
+│   └── core/
+│       └── {scope}/
+├── .skills/
+│   ├── sprint-forge/
+│   └── qa-review/
+└── src/
+```
+
+---
+
+## Onboarding Prompt
+
+```text
+Use Kyro for this project.
+
+Read:
+@file .agents/orchestrator.md
+@file .skills/sprint-forge/SKILL.md
+@file .skills/qa-review/SKILL.md
+
+Persist workflow artifacts under .agents/kyro/scopes/{scope}/.
+If slash commands are unavailable, use:
+- forge = analyze/plan/execute/review/close
+- status = read artifacts and report progress/debt
+- wrap-up = close session and update re-entry prompts
+```
+
+---
+
+## Example Flows
+
+### Sprint Planning
+
+```text
+@file .agents/orchestrator.md
+@file .skills/sprint-forge/SKILL.md
+
+Run the forge intent for {scope}.
+Create or update ROADMAP.md, findings, and the next sprint under
+.agents/kyro/scopes/{scope}/.
+```
+
+### QA Review
+
+```text
+@file .skills/qa-review/SKILL.md
+@file .agents/kyro/scopes/{scope}/RE-ENTRY-PROMPTS.md
+
+Review the current implementation against the sprint plan.
+Return blockers first, then warnings, then approval status.
+```
+
+### Session Wrap-Up
+
+```text
+@file .agents/orchestrator.md
+@file .skills/sprint-forge/SKILL.md
+
+Run the wrap-up intent for {scope}.
+Update retro notes, debt status, re-entry prompts, and proposed learned rules.
+```
+
+---
+
+## Limitations
+
+- OpenCode may not register Kyro commands or skills natively.
+- You must ensure generated artifacts are saved under `.agents/kyro/scopes/{scope}/`.
+- Learned rules are markdown-based and must be maintained in `rules.md`.
+
+For the generic adapter contract and Cursor notes, see [Agent Adapters](agent-adapters.md).