@haoyiyin/workflow 0.2.0

package/README.md

@@ -0,0 +1,168 @@
+# yi-workflow Skills
+
+Production workflow skills for planning, executing, reviewing, debugging, and finishing coding-agent work.
+
+## Simplified Workflow
+
+```text
+Trivial edit:     no skill needed — direct edit
+Small task:       quick-task
+New project:      to-plan → execute-plan (auto verify & finish)
+Existing project: agents-md → to-plan → execute-plan (auto verify & finish)
+```
+
+Use `agents-md` as step 0 only when an existing repository lacks agent instructions such as `AGENTS.md`, `CLAUDE.md`, or `CONTEXT.md`.
+
+**Key simplification**: `execute-plan` now includes auto-verification and finish menu. No need to manually run `verify-goal` or `finish-branch`.
+
+**Two-step flow**: `/to-plan` → user confirms (Y/Enter) → auto-triggers `/execute-plan` → auto-verify → auto-commit → finish options menu.
+
+## Skills
+
+Each skill is a self-contained workflow in `<name>/SKILL.md`. Pi auto-discovers skills from this directory structure.
+
+| Skill | Purpose | Trigger |
+|---|---|---|
+| `to-plan/` | Create implementation plan with subagents | `/to-plan` |
+| `execute-plan/` | Execute approved plan with auto-verify and finish menu | `/execute-plan` |
+| `quick-task/` | Handle small tasks with compact plan | `/quick-task` |
+| `review-diff/` | Review diff/branch/PR against plan/spec | `/review-diff` |
+| `tdd/` | Enforce RED/GREEN/REFACTOR | `/tdd` |
+| `systematic-debugging/` | Find root cause before fixes | `/systematic-debugging` |
+| `worktree-start/` | Prepare isolated git workspaces | `/worktree-start` |
+| `agents-md/` | Create/update repo agent instructions | `/agents-md` |
+| `caveman/` | Compress replies into terse prose | `/caveman` |
+
+## Skill Roles
+
+| Skill | Role | Trigger |
+|---|---|---|
+| `agents-md` | Create or update repository agent instructions | Repo instruction setup or maintenance |
+| `quick-task` | Run a small scoped task with compact plan and isolated subagent | Small fixes/features that are not trivial |
+| `to-plan` | Explore with subagents and write an implementation plan | User wants a plan, task breakdown, or issue/spec-to-plan |
+| `execute-plan` | Execute an approved plan with implementation subagents | User approves a plan for implementation |
+| `verify-goal` | Verify completed work against plan/spec goals | After execute-plan or when user asks if requirements are met |
+| `tdd` | Enforce RED/GREEN/REFACTOR for behavior changes | Implementation subagents and TDD requests |
+| `review-diff` | Review diffs against plan/spec/task requirements | PR/diff/task review |
+| `systematic-debugging` | Prove root cause before changing code | Failing tests, flaky behavior, regressions |
+| `worktree-start` | Prepare isolated git workspaces | Parallel or risky worktree-based execution |
+| `finish-branch` | Help choose merge/PR/keep/discard/cleanup | Work is implemented and ready to finish |
+| `caveman` | Compress user-facing reports only | User asks for caveman/brief/compressed replies |
+| `reflect` | Capture workflow feedback and turn it into skill improvements | User says "reflect", "反思", "retrospective", or after finish-branch |
+
+## Core Rules
+
+| Rule | Applies to |
+|---|---|
+| Top-level skills are manually invoked; do not auto-route based only on broad natural-language triggers | all skills except execute-plan internals |
+| `execute-plan` may autonomously orchestrate subagents only after explicit invocation/approval | `execute-plan` |
+| Default plan path is `.pi/plans/YYYY-MM-DD-<topic>-implementation-plan.md` | `to-plan`, `worktree-start`, `execute-plan` |
+| Plan files are stored in `.pi/plans/` (gitignored) and auto-cleaned after successful execution | `to-plan`, `worktree-start`, `execute-plan` |
+| E2E/raw evidence reports are not committed by default; distill findings into the plan or summary | `to-plan`, `execute-plan`, `review-diff` |
+| Subagent model selection is a blocking user-input gate; ask for the exact selector if unspecified | `to-plan`, `execute-plan` |
+| Do not query/list/guess models and do not fallback to current/default/main model | `to-plan`, `execute-plan` |
+| Exploration for plans must be done by subagents, not the main agent | `to-plan` |
+| After `to-plan` dispatches exploration subagents, the main agent must not read/search repo, source, plan, or workflow-reference files | `to-plan` |
+| Trivial edits need no skill; handle directly. Small scoped tasks use manual `quick-task`; complex work uses full planning | `quick-task`, `to-plan` |
+| Full plans are written to disk; chat output is summary only | `to-plan` |
+| Complex/high-context plans use a plan package instead of one oversized file | `to-plan`, `execute-plan` |
+| Plan-checker gate must pass before Plan Ready | `to-plan` |
+| Execution state is persisted before subagent dispatch and updated through review/integration | `execute-plan` |
+| Goal-backward verification checks task completion against user-visible truths before finish | `verify-goal` |
+| Skill descriptions stay under 180 chars and every skill declares `requires: [...]` | all skills |
+| TDD is required for behavior changes unless the plan marks a valid exception | `execute-plan`, `quick-task`, `tdd` |
+| After dispatching implementation work, the main agent must not read production/test source files or full diffs | `execute-plan`, `review-diff` |
+| Implementation agents must stay scoped to `Owns`/`Reads`; broad codebase exploration is a blocked-task signal | `execute-plan` |
+| Every completed task must have reviewer subagent reports or explicit user-approved waiver recorded in execution state before integration | `execute-plan` |
+| Small-scope review waiver requires ≤2 tasks, ≤3 files, all verifications PASS, no security/auth/data risk, and explicit user approval | `execute-plan` |
+| Main agent token budget target is 30-60K; checkpoint and stop if approaching 100K degraded territory | `execute-plan` |
+| `caveman` is only for user-facing presentation, never precision-critical prompts/evidence | `execute-plan`, `caveman` |
+
+## Progressive Disclosure
+
+Each `SKILL.md` stays small and operational. Reusable details live in `references/`.
+
+### Reference Files
+
+| Reference | Purpose |
+|---|---|
+| `references/model-selection.md` | Exact model selector gate |
+| `references/to-plan-template.md` | Full saved plan template |
+| `references/to-plan-subagent-prompts.md` | Exploration subagent prompt patterns |
+| `references/to-plan-post-subagent-gate.md` | Post-exploration synthesis checklist |
+| `references/to-plan-quality-gate.md` | Plan-checker gate and task-size thresholds |
+| `references/to-plan-non-negotiables.md` | to-plan structural rules |
+| `references/to-plan-prohibited.md` | to-plan forbidden actions and embargo |
+| `references/to-plan-workflow-details.md` | Expanded step instructions |
+| `references/to-plan-orchestration.md` | Phase-by-phase orchestration guide |
+| `references/execute-plan-token-budget.md` | Token budget tiers and discipline |
+| `references/execute-plan-checkpointing.md` | Checkpoint protocol and hard stop |
+| `references/execute-plan-checkpointing.md` | Checkpoint protocol and hard stop |
+| `references/execute-plan-orchestration.md` | Phase-by-phase orchestration guide |
+| `references/execute-plan-subagent-contract.md` | Implementer prompt/result contract |
+| `references/subagent-lifecycle.md` | Subagent dispatch and validation |
+| `references/execution-state-format.md` | State schema and resume handling |
+| `references/review-gate-protocol.md` | Review decision tree and waiver |
+| `references/execute-plan-non-negotiables.md` | execute-plan structural rules |
+| `references/execute-plan-prohibited.md` | execute-plan forbidden actions |
+| `references/execute-plan-modes.md` | Execution mode classification |
+| `references/tdd-playbook.md` | RED/GREEN/REFACTOR guidance |
+| `references/review-diff-checklist.md` | Review checklist details |
+| `references/review-diff-prohibited.md` | review-diff forbidden actions |
+| `references/debugging-playbook.md` | Root-cause debugging playbook |
+| `references/systematic-debugging-prohibited.md` | debugging forbidden actions |
+| `references/worktree-commands.md` | Worktree command details |
+| `references/worktree-start-prohibited.md` | worktree forbidden actions |
+| `references/finish-branch-commands.md` | Finish/merge/cleanup commands |
+| `references/finish-branch-prohibited.md` | finish-branch forbidden actions |
+| `references/goal-verification-checklist.md` | Goal-backward verification method |
+| `references/agents-md-style.md` | Agent instruction file style |
+| `references/agents-md-prohibited.md` | agents-md forbidden actions |
+| `references/tdd-prohibited.md` | TDD Iron Law and forbidden actions |
+
+## Custom Agents
+
+Preferred custom agents in `.pi/agents/` keep heavy role prompts out of main skills:
+
+| Agent | Role |
+|---|---|
+| `yi-implementer` | Scoped implementation with TDD and Owns/Reads discipline |
+| `yi-plan-checker` | Read-only plan-quality gate |
+| `yi-spec-reviewer` | Requirement/spec compliance review |
+| `yi-code-reviewer` | Code quality and risk review |
+| `yi-verifier` | Goal-backward verification |
+
+## SKILL.md Maintenance Contract
+
+Every `SKILL.md` includes:
+
+1. YAML frontmatter with `description: >-`.
+2. High-signal description: purpose, triggers, exclusions.
+3. `## Use / Exclude Matrix`.
+4. `## Workflow` with numbered steps.
+5. Every step: `Do:`, `Decide:`, `Produce:`.
+6. `## Output Spec` with fixed structure.
+7. `## Error Handling` as table.
+8. `## References` for delegated details.
+
+## Editing Guidance
+
+When changing skills:
+
+1. Update smallest relevant skill first.
+2. Move repeated policy/templates to `references/`.
+3. Keep triggers narrow enough to avoid accidental activation.
+4. Prefer Markdown tables for matrices/rules.
+5. Avoid vague instructions like "handle edge cases" without enumeration.
+6. Verify workflow steps remain executable.
+7. Keep frontmatter descriptions under 180 chars.
+
+## Validation
+
+Before considering edits complete:
+
+```bash
+python3 scripts/validate-skills.py
+```
+
+Checks: frontmatter, description length, `requires`, required sections, workflow steps with Do/Decide/Produce, placeholder terms, line count.

package/SETUP.md

@@ -0,0 +1,71 @@
+# Setup Guide
+
+## Installation
+
+### Global Installation
+
+```bash
+npm install -g yi-workflow
+```
+
+### Local Installation (per project)
+
+```bash
+npm install --save-dev yi-workflow
+```
+
+## Configuration
+
+### Package.json Configuration
+
+Add to your `package.json`:
+
+```json
+{
+  "pi": {
+    "skills": [
+      "dist/skills/to-plan/index.js",
+      "dist/skills/execute-plan/index.js"
+    ],
+    "hooks": [
+      "dist/hooks/builtin/*.js"
+    ],
+    "config": {
+      "planPath": ".pi/plans",
+      "statePath": ".pi/yi-workflow/state",
+      "autoCleanup": true,
+      "autoMerge": true,
+      "defaultModel": "haiku",
+      "maxConcurrent": 4
+    }
+  }
+}
+```
+
+### Initialize Project
+
+```bash
+yi-workflow install
+```
+
+This will:
+- Create `.pi/plans` directory
+- Create `.pi/yi-workflow/state` directory
+- Add `.pi/` to `.gitignore`
+- Update `package.json` with Pi configuration
+
+## Verification
+
+```bash
+# Check configuration
+yi-workflow validate
+
+# Check status
+yi-workflow status
+```
+
+## Environment Requirements
+
+- Node.js >= 18.0.0
+- Git repository (recommended)
+- Pi subagents system (optional, for full functionality)

package/SKILL.md

@@ -0,0 +1,68 @@
+# yi-workflow
+
+Plan-based workflow execution with fresh-context subagents.
+
+## When to Use
+
+Use this skill when the user wants to:
+- Create a structured plan for complex tasks
+- Execute a plan with parallel waves
+- Review code systematically
+- Debug issues with systematic approach
+- Use TDD (test-driven development)
+
+## Commands
+
+All yi-workflow commands are prefixed with `ywf-` to avoid conflicts with PI native commands:
+
+### /ywf-plan <goal>
+Create an execution plan for the given goal.
+
+### /ywf-execute
+Execute the current plan.
+
+### /ywf-task <description>
+Execute a quick task without planning.
+
+### /ywf-tdd <feature>
+Implement feature using TDD approach.
+
+### /ywf-review [target]
+Review code changes.
+
+### /ywf-debug <issue>
+Debug an issue systematically.
+
+### /ywf-status
+Show current workflow status.
+
+### /ywf-resume
+Resume interrupted workflow.
+
+## Workflow
+
+1. **Planning Phase**: Break down goal into tasks with dependencies
+2. **Execution Phase**: Execute tasks in parallel waves
+3. **Verification Phase**: Verify results meet acceptance criteria
+
+## Configuration
+
+Configuration is read from `package.json` under the `pi.config` key:
+
+```json
+{
+  "pi": {
+    "config": {
+      "planPath": ".pi/plans",
+      "statePath": ".pi/yi-workflow/state",
+      "defaultModel": "haiku",
+      "maxConcurrent": 4
+    }
+  }
+}
+```
+
+## State Files
+
+- `.pi/state/STATE.md` - Current workflow state
+- `.pi/state/PLAN.md` - Execution plan

package/USAGE.md

@@ -0,0 +1,152 @@
+# Usage Guide
+
+## Quick Start
+
+### 1. Create a Plan
+
+```bash
+yi-workflow plan "Add user authentication" --description "Implement login/logout with JWT"
+```
+
+This creates a plan at `.pi/plans/YYYY-MM-DD-add-user-authentication-implementation-plan.md`
+
+### 2. Review and Approve
+
+Open the plan file and review the tasks.
+
+### 3. Execute the Plan
+
+```bash
+yi-workflow execute .pi/plans/YYYY-MM-DD-add-user-authentication-implementation-plan.md
+```
+
+## Commands
+
+### plan
+
+Create an implementation plan.
+
+```bash
+yi-workflow plan <goal> [options]
+
+Options:
+  -o, --output <path>      Output path for plan
+  -d, --description <desc> Additional context
+```
+
+### execute
+
+Execute an approved plan.
+
+```bash
+yi-workflow execute <plan-path> [options]
+
+Options:
+  -s, --state <id>  Resume from state ID
+```
+
+### validate
+
+Validate configuration.
+
+```bash
+yi-workflow validate
+```
+
+### cleanup
+
+Clean up old files.
+
+```bash
+yi-workflow cleanup [options]
+
+Options:
+  -d, --days <days>  Clean files older than N days (default: 7)
+  --dry-run          Show what would be cleaned
+```
+
+### status
+
+View execution status.
+
+```bash
+yi-workflow status
+```
+
+### resume
+
+Resume execution from state.
+
+```bash
+yi-workflow resume [state-id]
+```
+
+### install
+
+Initialize yi-workflow in current project.
+
+```bash
+yi-workflow install
+```
+
+## Programmatic Usage
+
+```typescript
+import { createHookManager, createStateManager, toPlanSkill } from 'yi-workflow'
+
+const hookManager = createHookManager()
+const stateManager = createStateManager({
+  planPath: '.pi/plans',
+  statePath: '.pi/yi-workflow/state',
+  autoCleanup: true,
+  autoMerge: true,
+  defaultModel: 'haiku',
+  maxConcurrent: 4,
+})
+
+const result = await toPlanSkill.execute({
+  goal: 'Add user authentication',
+  context: 'Implement login/logout with JWT'
+}, {
+  config: { /* ... */ },
+  state: currentState,
+  logger: console
+})
+```
+
+## Workflow
+
+1. **Plan**: Use `yi-workflow plan` to create a plan
+2. **Review**: Manually review the generated plan
+3. **Execute**: Use `yi-workflow execute` to run the plan
+4. **Verify**: Automatic verification after execution
+5. **Finish**: Auto-commit, merge, and cleanup
+
+## Hooks
+
+Hooks are triggered automatically:
+
+- `pre-plan`: Before plan creation
+- `post-plan`: After plan creation
+- `pre-execute`: Before execution
+- `post-execute`: After execution (includes auto-commit)
+- `on-error`: When errors occur
+
+## State Management
+
+Execution state is persisted to `.pi/yi-workflow/state/`:
+
+- `active/`: Currently running executions
+- `archive/YYYY-MM-DD/`: Completed/failed executions
+
+Resume with:
+```bash
+yi-workflow resume [state-id]
+```
+
+## Tips
+
+- Keep plans in `.pi/plans/` (gitignored by default)
+- Use `--verbose` for detailed logging
+- Set `autoMerge: false` if you prefer manual merging
+- Clean old states regularly with `yi-workflow cleanup`

package/dist/bin/yi-workflow.d.ts

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

package/dist/bin/yi-workflow.d.ts.map

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

package/dist/bin/yi-workflow.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * yi-workflow CLI - Production workflow for coding agents
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { StateMdManager } from '../src/persistence/index.js';
+const program = new Command();
+program
+    .name('yi-workflow')
+    .description('Two-phase workflow (Plan → Execute) with fresh-context subagents')
+    .version('0.2.0');
+// Status command
+program
+    .command('status')
+    .description('Show workflow status')
+    .action(async () => {
+    try {
+        const stateManager = new StateMdManager();
+        const state = await stateManager.readCurrentState();
+        console.log(chalk.blue('Workflow Status'));
+        console.log(`Phase: ${state.phase}`);
+        console.log(`Goal: ${state.goal}`);
+        console.log(`Tasks: ${state.completedTasks.length}/${state.totalTasks}`);
+    }
+    catch {
+        console.log(chalk.yellow('No active workflow'));
+    }
+});
+// Health check
+program
+    .command('health')
+    .description('Check system health')
+    .action(async () => {
+    console.log(chalk.blue('System Health'));
+    console.log(chalk.green('✓ All systems operational'));
+});
+program.parse();
+//# sourceMappingURL=yi-workflow.js.map

package/dist/bin/yi-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yi-workflow.js","sourceRoot":"","sources":["../../bin/yi-workflow.ts"],"names":[],"mappings":";AACA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAiB,MAAM,6BAA6B,CAAA;AAE3E,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,kEAAkE,CAAC;KAC/E,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,iBAAiB;AACjB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,sBAAsB,CAAC;KACnC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,cAAc,EAAE,CAAA;QACzC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,gBAAgB,EAAE,CAAA;QACnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAA;QAC1C,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QACpC,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QAClC,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,cAAc,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,CAAA;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAA;IACjD,CAAC;AACH,CAAC,CAAC,CAAA;AAEJ,eAAe;AACf,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,qBAAqB,CAAC;KAClC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAA;IACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAA;AACvD,CAAC,CAAC,CAAA;AAEJ,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/src/agents/contracts.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Pre-built SubagentContracts for each subagent role.
+ *
+ * Each factory accepts role-specific parameters and returns a fully-formed
+ * SubagentContract ready for dispatch. The contracts encode:
+ *   - The exact permission set the subagent needs
+ *   - Which files it may own (modify) vs. read
+ *   - A structured prompt template
+ *   - An optional output schema for validation
+ */
+import type { SubagentContract } from './types.js';
+export interface ExplorerParams {
+    /** What the explorer should search for */
+    query: string;
+    /** Directories or file patterns to search within */
+    searchPaths: string[];
+    /** Files the explorer may read (beyond search results) */
+    readFiles?: string[];
+    /** Specific questions to answer */
+    questions?: string[];
+}
+export interface ImplementerParams {
+    /** Description of what to implement */
+    task: string;
+    /** Files the implementer may modify */
+    ownedFiles: string[];
+    /** Files the implementer may read for context */
+    readFiles?: string[];
+    /** Test command to run after implementation */
+    testCommand?: string;
+    /** Constraints or requirements */
+    constraints?: string[];
+}
+export interface ReviewerParams {
+    /** What to review (PR description, diff summary, etc.) */
+    target: string;
+    /** Files to review */
+    reviewFiles: string[];
+    /** Specific areas of concern */
+    focusAreas?: string[];
+    /** Review criteria */
+    criteria?: string[];
+}
+export interface DebuggerParams {
+    /** Description of the failure / bug */
+    issue: string;
+    /** Files likely involved in the bug */
+    suspectFiles: string[];
+    /** Error messages or stack traces */
+    errorOutput?: string;
+    /** Steps to reproduce */
+    reproSteps?: string[];
+}
+export interface VerifierParams {
+    /** The original goal / requirement */
+    goal: string;
+    /** The plan that was executed */
+    plan: string;
+    /** Files that were changed */
+    changedFiles: string[];
+    /** Acceptance criteria */
+    acceptanceCriteria: string[];
+}
+export interface ResearcherParams {
+    /** Research topic or question */
+    topic: string;
+    /** Specific questions to answer */
+    questions?: string[];
+    /** Search scope: technical, business, security, etc. */
+    scope?: 'technical' | 'business' | 'security' | 'general';
+    /** Maximum results to return */
+    maxResults?: number;
+    /** Time range for results (e.g., '1y', '6m', '1w') */
+    timeRange?: string;
+}
+/**
+ * Explorer contract: read-only, searches the codebase to answer questions
+ * about structure, dependencies, patterns, or specific implementations.
+ */
+export declare function explorerContract(params: ExplorerParams): SubagentContract;
+/**
+ * Implementer contract: writes code, runs tests, works in isolation.
+ * The implementer owns specific files and may modify them.
+ */
+export declare function implementerContract(params: ImplementerParams): SubagentContract;
+/**
+ * Reviewer contract: reads code changes and produces a structured review
+ * report covering correctness, style, security, and performance.
+ */
+export declare function reviewerContract(params: ReviewerParams): SubagentContract;
+/**
+ * Debugger contract: analyses failures, identifies root causes, and
+ * proposes minimal fixes. Read-only unless explicitly allowed to write.
+ */
+export declare function debuggerContract(params: DebuggerParams): SubagentContract;
+/**
+ * Verifier contract: goal-backward verification. Checks that the
+ * implemented changes actually satisfy the original requirements by
+ * working backward from the goal through each acceptance criterion.
+ */
+export declare function verifierContract(params: VerifierParams): SubagentContract;
+/**
+ * Researcher contract: searches the internet for information on a topic.
+ * Returns structured research findings with sources.
+ */
+export declare function researcherContract(params: ResearcherParams): SubagentContract;
+export interface WorktreeParams {
+    /** Branch name for the new worktree */
+    branchName: string;
+    /** Base branch to create from (default: main) */
+    baseBranch?: string;
+    /** Whether to enable full isolation */
+    isolation?: boolean;
+}
+/**
+ * Worktree contract: Creates isolated git worktrees for parallel work.
+ * Replaces the worktree-start skill with a direct subagent dispatch.
+ */
+export declare function worktreeContract(params: WorktreeParams): SubagentContract;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/src/agents/contracts.d.ts.map

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