orc-sdlc
Assess and execute engineering work on ORC-backed projects: choose proportional planning, implementation, debugging, validation and review. Preserve an assigned flow's role and outcomes. Excludes prod
SKILL.mdskills/orc-sdlc/SKILL.md
GitHubChoose the process that completes the task
Read repository instructions and the current handoff. Check the installed spec
CLI bridge and its registered specs before declaring ORC unavailable. Use a registered
ORC spec, or --mcp-http <selected ORC URL>/mcp / an existing secure stdio launcher;
per-agent MCP configuration is not required. An already connected MCP tool is also
supported. Select the readable project name and call context first, then fetch
the effective orc-sdlc with skill_read through that interface. Read relevant
knowledge, not every document. Inspect the actual code/artifact before asking
questions that it can answer. Report a connection gap only after checking the
available bridge and direct connection; preserve scope and never use stale guidance.
User scope, authorization and project requirements govern the process.
Start with the core problem: who needs what outcome, how the current path works, and what evidence would prove it improved. Trace the affected flow and reuse what already fits before choosing new code. For nontrivial or uncertain work, choose a task kind and effort level using Planning. Clear bounded edits can use the direct route below; size alone does not choose the process. Use the least machinery that completes the outcome safely. Reassess the route when new evidence changes scope, risk or dependencies.
Complete the development cycle
Context/recall -> extract requirements -> classify -> plan if needed -> implement -> test and validate completeness -> review/rework -> authorized Git delivery. These are checkpoints, not mandatory separate tasks or agents. Advance when the current checkpoint has enough evidence; do not substitute a plan, green tests or a review summary for the requested completed outcome. For investigation-only work, the completed artifact is the cited answer. Git delivery applies to changed artifacts within existing authorization; publishing requires its own authorization.
- Requirements: outcome, observable examples/criteria, constraints, exclusions, dependencies and consequential open decisions are understood. Use grill-me-style questioning only for unresolved choices: one question, recommendation, then wait.
- Classify by uncertainty, connected boundaries, impact and reversibility. Direct execution is for clear, low-risk work. Small auth/data/API changes can be high risk.
- Plan when choices, dependencies, migration or failure consequences need a shared approach; map steps and validation to criteria before dependent implementation.
- Implement the complete change using the project's patterns and security boundaries.
- Verify each original criterion against actual behavior and evidence, then review the final artifact. Rework returns to implementation and affected revalidation.
- Deliver the reviewed result through Git within authorization; identify the actual commit/PR and any unimplemented or unverified work. Never label that work complete.
Assess and route
| Situation | Approach and reference |
|---|---|
| Clear, bounded, low-risk change | Execute directly, validate affected behavior; Development |
| Outcome unclear or consequential design choices | Explore first, then ask one focused question with a recommendation; Planning |
| Reported failure | Reproduce and state root cause before fixing; debugging section in Development |
| Broad/cross-boundary work | Record a concise plan and useful milestones; Planning, then development |
| High-impact auth, storage, compatibility or rollout change | Assess failure/migration/recovery and validation first; planning, then development even if the patch is small |
| Review existing work | Evaluate the actual artifact independently; review section in Review and delivery |
| Assigned managed node | Keep its task/session/checkout, role, declared outcomes and flow; load only its relevant reference |
| Rework or resume | Refresh feedback and effective guidance; preserve prior valid evidence and recheck changed behavior |
After compaction restore the supplied ORC session with session_restore, then
refresh the task, feedback, effective skills and relevant knowledge. Do not invent
an ORC session when none exists; use the existing repository handoff instead.
An engineering request alone does not require a managed flow, decomposition or
another agent. When coordination/review is warranted, inspect effective flows:
orc-default for development with its configured agent-review preference,
orc-human-review for independent review plus human signoff, orc-review-only
for an existing artifact. Follow project requirements and assigned flows; never
start duplicate agents or replace a missing flow silently. Delegation requires
user/project authorization. A worker cannot perform its own independent review.
Use orc-platform only when ORC operation details are needed. Select references
on demand; do not preload all playbooks. During work, preserve scope and unrelated
changes, record meaningful decisions/progress, and verify the actual acceptance
criteria. Before delivery or a flow outcome, follow the delivery section of
Review and delivery.
Learning accompanies the cycle: recall relevant project memories and cited KB
lessons before decisions; record meaningful task/session evidence during work;
reconcile short durable facts and verified KB lessons at review/delivery. Reuse
what the previous agent recorded, not only your native chat history. For memory,
Learnings KB/digest operation and cross-agent scope use the relevant platform
reference. A normal worker does not call digest_complete or schedule another agent
as a side effect of learning; that completion token belongs to an assigned digest run.
For managed nodes the graph owns task status. Report exactly one declared outcome with evidence, then stop; do not run the next node yourself. Outside a flow, deliver the result and use only the agreed manual task lifecycle. Completion/review does not authorize publishing, merging, deployment or live installation changes.