agentsys 5.0.3 → 5.2.0

package/adapters/codex/skills/next-task/SKILL.md

@@ -1,546 +0,0 @@
-<!-- AUTO-GENERATED by scripts/gen-adapters.js - DO NOT EDIT -->
----
-name: next-task
-description: "Use when user asks to \"find next task\", \"what should I work on\", \"automate workflow\", \"implement and ship\", \"run next-task\". Orchestrates complete task-to-production workflow: discovery, implementation, review, and delivery."
----
-
-# /next-task - Master Workflow Orchestrator
-
-Discover what to work on next and execute the complete implementation workflow.
-
----
-
-<no-shortcuts-policy>
-## No Shortcuts Policy
-
-This workflow exists because each step serves a purpose. Taking shortcuts defeats the purpose of automation.
-
-| Step | Purpose | What Happens If Skipped |
-|------|---------|------------------------|
-| Worktree creation | Parallel task isolation | Conflicts, lost work |
-| Review loop (3 iterations) | Catches bugs humans miss | Bugs ship to production |
-| 3-minute CI wait | Auto-reviewers need time | Miss critical feedback |
-| Address all PR comments | Quality gate | Merge blocked, trust lost |
-
-### Enforcement Rules
-
-1. Every step is mandatory - not suggestions, not guidelines, requirements
-2. Use the specified agents - do not substitute with manual commands
-3. Output verification blocks - prove each step completed
-4. If you think a step is unnecessary, review the "What Happens If Skipped" column above
-
-### Forbidden Shortcuts
-
-- `git checkout -b` or `git branch` instead of `worktree-manager` agent
-- Single CI check instead of monitoring loop
-- Rationalizing skips ("it's faster", "not needed this time")
-</no-shortcuts-policy>
-
----
-
-## Workflow Overview
-
-**Phases 1-6 (User Interaction):**
-1. Policy Selection
-2. Task Discovery
-3. Worktree Setup
-4. Exploration
-5. Planning
-6. User Approval
-
-**Phases 7-12 (Autonomous):**
-7. Implementation
-8. Pre-Review Gates
-9. Review Loop
-10. Delivery Validation
-11. Docs Update
-12. `ship:ship`
-
-**Human interaction points (ONLY THESE):**
-1. Policy selection via checkboxes
-2. Task selection from ranked list
-3. Plan approval (EnterPlanMode/ExitPlanMode)
-
-<workflow-gates>
-## Workflow Gates
-
-Each phase must complete before the next starts:
-
-| Gate | Requirement |
-|------|-------------|
-| Implementation | Agent completes all plan steps |
-| Pre-Review | deslop-agent + test-coverage-checker (parallel) |
-| Review Loop | Must approve (no open issues or override) |
-| Delivery | Tests pass, build passes |
-| Docs | Documentation updated |
-| Ship | Explicit `ship:ship` invocation (plugin command) |
-
-**Forbidden actions for agents:**
-- No agent may create PRs or push to remote (only ship:ship)
-- No agent may skip Phase 9, delivery-validator, or docs update
-</workflow-gates>
-
-## Arguments
-
-Parse from $ARGUMENTS:
-- `--status`: Show current workflow state and exit
-- `--resume [task/branch/worktree]`: Continue from last checkpoint
-- `--abort`: Cancel workflow and cleanup
-- `--implement`: Skip to implementation after task selection
-- `[filter]`: Task filter (bug, feature, security, test)
-
-### Resume Syntax
-
-```
-/next-task --resume                     # Resume active worktree (if only one)
-/next-task --resume 123                 # Resume by task ID
-/next-task --resume feature/my-task-123 # Resume by branch name
-/next-task --resume ../worktrees/my-task-123  # Resume by worktree path
-```
-
-## Default Behavior (No Arguments)
-
-1. Goes to Phase 1: Policy Selection
-2. Policy selector checks for existing tasks in `{stateDir}/tasks.json`
-3. If existing tasks found, **ASKS USER** what to do
-4. Then continues with normal policy configuration
-
-The workflow never auto-resumes. It always asks first.
-
-<opencode-constraint>
-## OpenCode Label Limit
-
-All request_user_input option labels must be ≤30 characters. Put details in `description`, not `label`.
-</opencode-constraint>
-
-## State Management
-
-Uses `lib/state/workflow-state.js` for all state operations:
-
-| File | Location | Purpose |
-|------|----------|---------|
-| `tasks.json` | Main repo `{stateDir}/` | Active task registry |
-| `flow.json` | Worktree `{stateDir}/` | Workflow progress |
-
-Key functions:
-- `workflowState.startPhase(phase)` - Begin a phase
-- `workflowState.completePhase(result)` - Complete and advance
-- `workflowState.updateFlow(updates)` - Partial state updates
-- `workflowState.hasActiveTask()` - Check for existing work
-- `workflowState.canResume()` - Check if resumable
-
-## Pre-flight: Handle Arguments
-
-```javascript
-const { getPluginRoot } = require('./lib/cross-platform');
-const path = require('path');
-const pluginRoot = getPluginRoot('next-task');
-const workflowState = require(path.join(pluginRoot, 'lib/state/workflow-state.js'));
-const args = '$ARGUMENTS'.split(' ').filter(Boolean);
-
-// No flags → Phase 1 (Policy Selection asks about existing tasks)
-if (args.length === 0) {
-  console.log("Starting Phase 1 (Policy Selection)");
-}
-
-// Handle --status, --abort, --resume via workflowState functions
-if (args.includes('--status')) {
-  const summary = workflowState.getFlowSummary();
-  console.log(summary ? `Phase: ${summary.phase} | Task: ${summary.task}` : "No active workflow.");
-  return;
-}
-
-if (args.includes('--abort')) {
-  workflowState.abortWorkflow('User requested abort');
-  return;
-}
-
-if (args.includes('--resume')) {
-  // Use lib functions to find worktree and resume from last phase
-  const flow = workflowState.readFlow();
-  if (flow && workflowState.canResume()) {
-    console.log(`Resuming from phase: ${flow.phase}`);
-  }
-}
-```
-
-<phase-1>
-## Phase 1: Policy Selection
-
-No agent needed. Use request_user_input tool with ALL 3 questions from `lib/sources/policy-questions.js`.
-
-**MANDATORY - Ask ALL 3 Questions:**
-
-| # | Header | Question | Options |
-|---|--------|----------|---------|
-| 1 | Source | Where should I look for tasks? | GitHub Issues, GitLab Issues, Local tasks.md, Custom, Other (+ cached if exists) |
-| 2 | Priority | What type of tasks to prioritize? | All, Bugs, Security, Features |
-| 3 | Stop Point | How far should I take this task? | Merged, PR Created, Implemented, Deployed, Production |
-
-**Forbidden Actions:**
-- Skipping any of the 3 questions
-- Inventing your own questions instead of using the exact ones above
-- Proceeding to Phase 2 without all 3 answers
-
-```javascript
-// Reference implementation - use ALL questions
-const { sources } = require(path.join(pluginRoot, 'lib'));
-const { questions, cachedPreference } = sources.getPolicyQuestions();
-// questions array contains all 3 questions above
-request_user_input({ questions }); // Pass all 3 questions
-const policy = sources.parseAndCachePolicy(responses);
-workflowState.updateFlow({ policy, phase: 'task-discovery' });
-```
-</phase-1>
-
-<phase-2>
-## Phase 2: Task Discovery
-
-**Agent**: `next-task:task-discoverer` (sonnet)
-
-```javascript
-workflowState.startPhase('task-discovery');
-await Task({
-  subagent_type: "next-task:task-discoverer",
-  prompt: `Discover tasks from source: ${JSON.stringify(policy.taskSource)}. Filter: ${policy.priorityFilter}. Present top 5 for selection.`
-});
-```
-</phase-2>
-
-<phase-3>
-## Phase 3: Worktree Setup
-
-**Blocking gate** - Cannot proceed to Phase 4 without completing this.
-
-Spawn: `next-task:worktree-manager` (haiku)
-
-```javascript
-workflowState.startPhase('worktree-setup');
-
-// Required - use this agent, not manual git commands
-const worktreeResult = await Task({
-  subagent_type: "next-task:worktree-manager",
-  prompt: `Create worktree for task #${state.task.id}. Anchor pwd to worktree.`
-});
-
-// Verification - mandatory before proceeding
-if (!worktreeResult.worktreePath) {
-  throw new Error('[BLOCKED] Worktree creation failed - STOP');
-}
-console.log(`[VERIFIED] Worktree: ${worktreeResult.worktreePath}`);
-```
-
-### Forbidden Actions for Phase 3
-- `git checkout -b <branch>` (use worktree-manager agent)
-- `git branch <branch>` (use worktree-manager agent)
-- Proceeding to Phase 4 without worktree verification output
-- Skipping worktree "because branching is faster"
-</phase-3>
-
-<phase-4>
-## Phase 4: Exploration
-
-**Agent**: `next-task:exploration-agent` (opus)
-
-```javascript
-workflowState.startPhase('exploration');
-await Task({
-  subagent_type: "next-task:exploration-agent",
-  model: "opus",
-  prompt: `Deep codebase analysis for task #${state.task.id}. Find key files, patterns, dependencies.`
-});
-```
-</phase-4>
-
-<phase-5>
-## Phase 5: Planning
-
-**Agent**: `next-task:planning-agent` (opus)
-
-```javascript
-workflowState.startPhase('planning');
-const planOutput = await Task({
-  subagent_type: "next-task:planning-agent",
-  model: "opus",
-  prompt: `Design implementation plan for task #${state.task.id}. Output structured JSON between === PLAN_START === and === PLAN_END === markers.`
-});
-```
-</phase-5>
-
-<phase-6>
-## Phase 6: User Approval (Plan Mode)
-
-**Last human interaction point.** Present plan via EnterPlanMode/ExitPlanMode.
-
-```javascript
-EnterPlanMode();
-// User reviews and approves via ExitPlanMode
-workflowState.completePhase({ planApproved: true, plan });
-```
-</phase-6>
-
-<phase-7>
-## Phase 7: Implementation
-
-**Agent**: `next-task:implementation-agent` (opus)
-
-```javascript
-workflowState.startPhase('implementation');
-await Task({
-  subagent_type: "next-task:implementation-agent",
-  model: "opus",
-  prompt: `Execute approved plan for task #${state.task.id}. Commit changes incrementally.`
-});
-// → SubagentStop hook triggers pre-review gates
-```
-</phase-7>
-
-<phase-8>
-## Phase 8: Pre-Review Gates
-
-**Agents** (parallel): `deslop:deslop-agent` + `next-task:test-coverage-checker` (sonnet)
-
-```javascript
-workflowState.startPhase('pre-review-gates');
-
-// Helper to parse deslop structured output
-function parseDeslop(output) {
-  const match = output.match(/=== DESLOP_RESULT ===[\s\S]*?({[\s\S]*?})[\s\S]*?=== END_RESULT ===/);
-  return match ? JSON.parse(match[1]) : { fixes: [] };
-}
-
-// Run deslop and test-coverage in parallel
-const [deslopResult, coverageResult] = await Promise.all([
-  Task({
-    subagent_type: "deslop:deslop-agent",
-    prompt: `Scan for AI slop patterns.
-Mode: apply
-Scope: diff
-Thoroughness: normal
-
-Return structured results between === DESLOP_RESULT === markers.`
-  }),
-  Task({ subagent_type: "next-task:test-coverage-checker", prompt: `Validate test coverage.` })
-]);
-
-// If fixes found, spawn simple-fixer
-const deslop = parseDeslop(deslopResult);
-if (deslop.fixes && deslop.fixes.length > 0) {
-  await Task({
-    subagent_type: "next-task:simple-fixer",
-    model: "haiku",
-    prompt: `Apply these slop fixes:
-${JSON.stringify(deslop.fixes, null, 2)}
-
-For each fix:
-- remove-line: Delete the line at the specified line number
-- add-comment: Add "// Error intentionally ignored" to empty catch
-
-Use Edit tool to apply. Commit message: "fix: clean up AI slop"`
-  });
-}
-```
-</phase-8>
-
-<phase-9>
-## Phase 9: Review Loop
-
-**Blocking gate** - Must run iterations before delivery validation.
-
-**CRITICAL**: You MUST spawn multiple parallel reviewer agents. Do NOT use a single generic reviewer.
-
-### Step 1: Get Changed Files
-
-```bash
-git diff --name-only main...HEAD
-```
-
-### Step 2: Detect Signals for Conditional Specialists
-
-Based on changed files, detect which additional specialists are needed:
-
-| Signal | Pattern | Specialist |
-|--------|---------|------------|
-| hasDb | `/(db\|migrations?\|schema\|prisma\|sql)/i` | database specialist |
-| hasApi | `/(api\|routes?\|controllers?\|handlers?)/i` | api designer |
-| hasFrontend | `/\.(tsx\|jsx\|vue\|svelte)$/` | frontend specialist |
-| hasBackend | `/(server\|backend\|services?\|domain)/i` | backend specialist |
-| hasDevops | `/(\.github\/workflows\|Dockerfile\|k8s\|terraform)/i` | devops reviewer |
-| needsArchitecture | 20+ changed files | architecture reviewer |
-
-### Step 3: Spawn ALL Reviewer Agents in Parallel
-
-**MANDATORY**: Spawn these 4 core reviewers (ALWAYS) + any conditional specialists detected above.
-
-```javascript
-// 4 CORE REVIEWERS - ALWAYS SPAWN ALL 4 IN PARALLEL
-const coreReviewers = [
-  { role: 'code quality reviewer', focus: 'Style, best practices, bugs, error handling, duplication' },
-  { role: 'security reviewer', focus: 'Auth flaws, input validation, injection, secrets exposure' },
-  { role: 'performance reviewer', focus: 'N+1 queries, blocking ops, hot path issues, memory leaks' },
-  { role: 'test coverage reviewer', focus: 'Missing tests, edge cases, test quality, mock appropriateness' }
-];
-
-// Spawn ALL 4 core reviewers in parallel using Task tool
-const reviewResults = await Promise.all([
-  Task({ subagent_type: 'general-purpose', model: 'sonnet',
-    prompt: `You are a code quality reviewer. Review these files: ${files.join(', ')}
-Focus: Style and consistency, Best practices, Bugs and logic errors, Error handling, Maintainability, Duplication
-Return findings as JSON array with: file, line, severity (critical/high/medium/low), description, suggestion` }),
-  Task({ subagent_type: 'general-purpose', model: 'sonnet',
-    prompt: `You are a security reviewer. Review these files: ${files.join(', ')}
-Focus: Auth/authz flaws, Input validation, Injection risks, Secrets exposure, Insecure defaults
-Return findings as JSON array with: file, line, severity (critical/high/medium/low), description, suggestion` }),
-  Task({ subagent_type: 'general-purpose', model: 'sonnet',
-    prompt: `You are a performance reviewer. Review these files: ${files.join(', ')}
-Focus: N+1 queries, Blocking operations, Hot path inefficiencies, Memory leaks
-Return findings as JSON array with: file, line, severity (critical/high/medium/low), description, suggestion` }),
-  Task({ subagent_type: 'general-purpose', model: 'sonnet',
-    prompt: `You are a test coverage reviewer. Review these files: ${files.join(', ')}
-Focus: Missing tests, Edge case coverage, Test quality, Integration needs, Mock appropriateness
-Return findings as JSON array with: file, line, severity (critical/high/medium/low), description, suggestion` })
-]);
-
-// Add conditional specialists based on signals (spawn in parallel with appropriate prompts)
-```
-
-### Step 4: Aggregate Findings
-
-Combine all reviewer findings, deduplicate by file+line+description, group by severity.
-
-### Step 5: Fix Issues (severity order: critical -> high -> medium -> low)
-
-For each finding, use Edit tool to apply the suggested fix. Commit after each batch.
-
-### Step 6: Iterate Until Clean (max 5 iterations)
-
-Repeat steps 3-5 until:
-- `openCount === 0` (all issues resolved) -> approved
-- 3+ iterations with only medium/low issues -> orchestrator may override
-- 5 iterations reached -> blocked
-
-### Review Iteration Rules
-- MUST run at least 1 full iteration with ALL 4 core reviewers
-- Do NOT use a single generic reviewer - spawn all specialists in parallel
-- Orchestrator may override after 3+ iterations if only medium/low issues remain
-- Do not skip directly to delivery validation
-- Do not claim "review passed" without spawning the reviewer agents
-
-### Verification Output (MANDATORY)
-
-After review loop completes, output:
-```
-[VERIFIED] Review Loop Complete
-- Iterations: N
-- Core reviewers spawned: code-quality, security, performance, test-coverage
-- Conditional specialists: [list any that were added]
-- Findings resolved: X critical, Y high, Z medium
-- Status: approved | blocked
-```
-</phase-9>
-
-<phase-10>
-## Phase 10: Delivery Validation
-
-**Agent**: `next-task:delivery-validator` (sonnet)
-
-```javascript
-workflowState.startPhase('delivery-validation');
-const result = await Task({
-  subagent_type: "next-task:delivery-validator",
-  prompt: `Validate completion. Check: tests pass, build passes, requirements met.`
-});
-if (!result.approved) {
-  workflowState.failPhase(result.reason, { fixInstructions: result.fixInstructions });
-  return; // Retries from implementation
-}
-```
-</phase-10>
-
-<phase-11>
-## Phase 11: Docs Update
-
-**Agent**: `sync-docs:sync-docs-agent` (sonnet)
-
-Uses the unified sync-docs agent from the sync-docs plugin with `before-pr` scope.
-
-```javascript
-workflowState.startPhase('docs-update');
-
-// Helper to parse sync-docs structured output
-function parseSyncDocsResult(output) {
-  const match = output.match(/=== SYNC_DOCS_RESULT ===[\s\S]*?({[\s\S]*?})[\s\S]*?=== END_RESULT ===/);
-  return match ? JSON.parse(match[1]) : { issues: [], fixes: [], changelog: { status: 'ok' } };
-}
-
-// Run sync-docs with before-pr scope
-const syncResult = await Task({
-  subagent_type: "sync-docs:sync-docs-agent",
-  prompt: `Sync documentation with code state.
-Mode: apply
-Scope: before-pr
-
-Execute the sync-docs skill and return structured results.`
-});
-
-// Parse results from === SYNC_DOCS_RESULT === markers
-const result = parseSyncDocsResult(syncResult);
-
-// If fixes are needed, spawn simple-fixer
-if (result.fixes && result.fixes.length > 0) {
-  await Task({
-    subagent_type: "next-task:simple-fixer",
-    model: "haiku",
-    prompt: `Apply these documentation fixes:
-${JSON.stringify(result.fixes, null, 2)}
-
-Use the Edit tool to apply each fix. Commit message: "docs: sync documentation with code changes"`
-  });
-}
-
-workflowState.completePhase({ docsUpdated: true, fixesApplied: result.fixes?.length || 0 });
-```
-</phase-11>
-
-<phase-12>
-## Phase 12: Handoff to ship:ship
-
-After docs update (sync-docs-agent) completes, invoke `ship:ship` explicitly:
-
-```javascript
-console.log(`Task #${state.task.id} passed all validation. Invoking ship:ship...`);
-const stateDir = workflowState.getStateDir(); // Returns platform-aware state directory
-await Task({ subagent_type: "ship:ship", prompt: `Ship the task. State file: ${stateDir}/flow.json` });
-```
-
-**ship:ship responsibilities:**
-- Create PR, push branch
-- Monitor CI and review comments
-- Merge when approved
-- Cleanup worktree and tasks.json
-</phase-12>
-
-## Error Handling
-
-```javascript
-try {
-  // ... workflow phases ...
-} catch (error) {
-  workflowState.failPhase(error.message);
-  console.log(`Workflow failed. Use --resume to retry or --abort to cancel.`);
-}
-```
-
-## Success Criteria
-
-- Policy selection via checkboxes
-- Two-file state management (tasks.json + flow.json)
-- Resume by task ID, branch, or worktree path
-- Worktree isolation for parallel workflows
-- Opus for complex tasks (explore, plan, implement)
-- Sonnet for validation tasks (review, delivery)
-- Haiku for simple tasks (worktree)
-- Fully autonomous after plan approval
-- Explicit ship:ship handoff for PR workflow
-
-Begin workflow now.