Use proactively to run this repo's test suites and g-dev/ gate fixtures and return attested runner output. The execution counterpart to test-writer, which has no execution tool and cannot run anything — g-forge-dev closes that gap for THIS repo's own dogfooded plugin code only.
Use proactively when files in layer-boundary directories change. Validates import direction, circular deps, and separation of concerns. Reports violations with file:line refs. Does not fix.
Use before any merge and when project-manager needs technical risk assessment. Guards milestone feasibility, checks done conditions, and reviews diffs directly. Does not implement.
Use proactively after any code change and before every merge. Reviews for logic errors, code smells, DRY violations, and edge cases. Reports with file:line refs and severity. Does not fix.
Use proactively before any release and whenever the dependency manifest changes. Audits for security advisories, deprecated packages, license conflicts, and unused declarations. Does not fix or upgrade.
Use proactively when documentation changes, when public exports change, or at milestone close. Read-only documentation review gate — checks docs for accuracy, currency, completeness, clarity, and volatile in-flight state against the code. Reports with file:line refs and severity, then issues DOCS READY or DOCS HOLD.…
Use proactively when facing cryptic errors or production incidents before attempting a fix. Parses logs and stack traces to identify patterns and root causes. Does not fix.
The generic, stack-agnostic wave implementer — the default executor for any implementation task that has no matching stack implementer installed by /g-specialize, and the fallback for projects that have not been specialized. Implements one wave task to its done condition. Single-use — one approach, one attempt.…
Use proactively on performance-sensitive changes. Flags O(n²) paths, N+1 queries, unnecessary re-renders, and hot-path waste. Reports with file:line refs and estimated impact. Does not fix.
The user-facing interface for every session. The user talks to the PM — not to a neutral assistant. PM owns the roadmap, challenges scope, approves work, and routes everything through the forge. Does not write code or touch implementation files.
Coordinates the full review pipeline — code review, architecture, security, and performance in parallel. Aggregates findings into one report. Does not review itself. Must run as the root session agent (--agent review-orchestrator or directly from a skill in the main session) — spawning it as a nested subagent prevents…
Use proactively before any merge, especially those touching auth or external integrations. Audits for OWASP Top 10 vulnerabilities, injection vectors, and secrets exposure. Does not fix.
Use when a task needs to be specced before handoff to an executor. Produces an implementation spec precise enough for a Haiku agent to execute without judgment calls.
Use proactively after implementing code that needs coverage or when spec-writer produces a spec. Writes unit, integration, or e2e tests. Fixed data only, no Date.now() or random values.
Use immediately after task-decomposer. Takes a task list and produces a parallel wave execution schedule by mapping dependencies, and tags each task with the executor agent that should run it.