korenko-git/opencode-setup/subagent-driven-development

Subagent-Driven Development

Use this workflow only for tasks with clear boundaries and non-overlapping files. Read the plan and repository first; resolve dependencies and ambiguity before dispatching work.

1. Use Task with subagent_type: explore for a bounded codebase question.
2. Dispatch one isolated change at a time with subagent_type: implementation.

Include the task goal, relevant paths, constraints, expected tests, and a report format. Do not assume subagents share session context.

1. Inspect the resulting diff and verification. For risky or broad changes,

use Task with subagent_type: code-reviewer and provide the requirements and diff scope.

1. Resolve findings, run the relevant verification, then continue to dependent

tasks. Use lightweight only for concise read-only analysis when appropriate.

Do not parallelize changes that can conflict. Stop and use question when a task is blocked or the plan needs a material decision. Do not create worktrees, state directories, or commits automatically.

Bundled scripts

When a task explicitly needs these helpers, set SKILL_DIR to the absolute directory containing this file and invoke them from there, never from the user project: "$SKILL_DIR/scripts/task-brief", "$SKILL_DIR/scripts/review-package", and "$SKILL_DIR/scripts/sdd-workspace". The workspace name is a SHA-256 slug of the canonical plan path, so plans with the same basename receive separate workspaces.

Uncommitted task review scope

Do not require a commit to review a task. Before dispatching an uncommitted task review, write that task's repository-relative paths to a NUL-delimited file and pass it to review-package:

printf '%s\0' 'path with spaces/file.py' 'another-file.py' > "$WORKSPACE/task-N-paths"
"$SKILL_DIR/scripts/review-package" "$PLAN_FILE" \
  --pathspec-file "$WORKSPACE/task-N-paths" \
  "$WORKSPACE/task-N-review.diff"

This packages only the selected staged, unstaged, and untracked paths. Use a separate path list and output file for each task or fix round, so an earlier uncommitted task cannot enter a later task's review. --pathspec-file reads NUL-delimited entries and passes each to Git as a literal pathspec, so paths containing spaces, newlines, or leading : characters are safe. The existing PLAN_FILE, PLAN_FILE BASE HEAD, and PLAN_FILE BASE HEAD OUTFILE forms remain available for whole-working-tree and commit-range reviews.