engineer

Classifies engineering requests into lanes and orchestrates confirmed skill chains per lane.

Updated May 21, 2026
One-click install
npx skills add https://github.com/CagesThrottleUs/private-ai-harness --skill engineer-cagesthrottleus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: engineer
Source: https://github.com/CagesThrottleUs/private-ai-harness/tree/main/skills/engineer
Command: npx skills add https://github.com/CagesThrottleUs/private-ai-harness --skill engineer-cagesthrottleus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Engineering requests arrive with wildly different scope — a one-line typo fix and a multi-week epic should not follow the same process. This Skill acts as a single entry point that classifies any request into a lane (quick-fix, task, epic, portfolio, research, or refactoring), proposes the right skill chain, and waits for confirmation before any work begins, preventing both under-process on big work and over-process on small fixes. ## Core Features & Use Cases - Lane classification with ambiguity rules: Signal tables classify requests by magnitude, with one targeted clarifying question when signals conflict (e.g., fix-vs-refactor, task-vs-epic). - Confirmed execution plans: Presents the detected lane, reasoning, proposed skill chain, and skipped skills with reasons — no skill fires until the user approves. - Lane-specific workflows: Quick-fix runs debugging plus TDD; task runs comprehension, spec gate, planning, worktrees, and review; epic adds business intake, HLD, decomposition, deployment, and production-readiness gates; portfolio sequences epics via WSJF and WIP limits. - Cost observability and circuit breaker: The bundled cost-checkpoint script brackets every step and subagent dispatch with token snapshots, appends rows to a cross-repo JSONL ledger, and can halt execution when a session token cap is breached. - Use Case: A user types "/engineer the login endpoint returns 500 after password reset". The Skill classifies it as quick-fix, proposes systematic-debugging plus TDD plus commit-discipline, waits for confirmation, then executes the chain with per-step cost tracking. ## Quick Start Ask the AI to run /engineer followed by a description of your engineering task, then confirm the proposed lane and skill chain it presents.

Frequently Asked Questions about engineer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I route an engineering task through a structured workflow?

Invoke /engineer with a plain-language description of the work. The Skill classifies it into a lane (quick-fix, task, epic, portfolio, research, or refactoring), presents the proposed skill chain with reasoning, and starts execution only after you confirm.

What is the difference between the quick-fix and task lanes?

Quick-fix covers single-symbol defects with an obvious root cause and skips the spec-and-plan loop. Task covers bounded features that may add an endpoint or component and always runs brainstorming, a spec quality gate, and plan writing before construction.

How does the cost-checkpoint script track token usage?

It snapshots cumulative session tokens from the Claude Code or Codex transcript at step start and end, diffs them, and appends one JSON row per step to a global append-only ledger file. A budget subcommand compares cumulative tokens against a caller-supplied cap and exits with code 3 on breach.

Can I set a spending limit on an automated engineering run?

Yes. Run cost-checkpoint budget with a --cap value before each step; the script returns ok, warning at 80 percent of cap, or breach. On breach the orchestrator halts like a BLOCKED state and waits for human resolution.

When does the formal-verification step fire?

Only when the change touches a critical core such as cryptography, auth decisions, or monetary arithmetic AND the target language has a verifier like Verus, Dafny, SPARK, Frama-C, OpenJML, or CBMC. Otherwise the invariant routes to property-based testing instead.

What happens when a review gate returns FAIL?

Every gate is hard-blocking: the workflow never auto-continues past a FAIL or BLOCKED status. The failure is surfaced to the human, who must resolve it before the lane advances to the next phase.