SIFAP workshop orchestration
Run the workshop as five evidence-gated stages while keeping reusable procedures in companion skills.
When to invoke
- "Start the SIFAP archaeology stage."
- "Check whether the team can hand off to architecture."
- "Coordinate the SIFAP build stage."
- "Prepare the final operations and review stage."
Inputs
Use $ARGUMENTS to select one stage. If absent, infer the current stage only from artifacts that exist
in the target repository; otherwise ask the team to choose. Never create a branch or GitHub mutation
solely from an inferred stage.
Stage contract
| Stage |
Lead agent |
Required input |
Primary output |
Exit gate |
| Archaeology |
sifap-archaeologist |
Legacy corpus and scope |
Inventory, dependencies, rule candidates, questions |
Behavior claims cite inspected legacy evidence. |
| Architecture |
sifap-architect |
Approved rule candidates and scope |
REQ-NNN specs, ADRs, modular-monolith plan |
Requirements validate and unresolved meaning is not promoted. |
| Build |
sifap-builder |
Approved requirements, plan, and bounded slice |
Modern code and equivalence tests |
Focused tests and builds pass; drift is classified. |
| Quality |
sifap-quality |
Implemented slice and in-scope legacy files |
Requirement verification, migration mapping, reconciliation numbers |
Every requirement is verified and every in-scope file reconciles or is explicitly excluded. |
| Operations |
sifap-operations |
Verified implementation and operational scope |
Hardening, reviewed issues/PRs, IaC evidence, runbook, retrospective |
Human approvals and validation evidence are recorded. |
Procedure
- Load
sifap-modernization-context and the task-relevant references.
- Inspect the selected stage's required inputs; report missing inputs and stop before side effects.
- Invoke or hand off to the stage agent with objective, scope, evidence paths, decisions, and open
questions. The stage agent loads its named companion skills before acting.
- Use
sifap-loop to run the stage as a bounded correction loop and to evaluate its gate.
- Keep progress evidence-based; do not satisfy gates with arbitrary counts or generated placeholders.
- Evaluate every exit-gate item and identify blockers, unrun checks, and owner decisions.
- Hand off only the minimum durable context needed by the next stage.
Branch and mutation policy
The workshop may use spec/<NNN>-<feature>, impl/<NNN>-<feature>, infra/<component>,
docs/<topic>, and agent/<issue-NN>. Confirm the target repository's real branch policy before branch
creation. Do not stage, commit, push, open an issue, assign an agent, review a PR, merge, deploy, or run
an infrastructure mutation without the applicable explicit approval.
Handoff contract
## SIFAP stage handoff
**From:** <stage and agent>
**To:** <stage and agent>
**Status:** ready | blocked
### Objective and scope
- <bounded outcome>
### Evidence and decisions
- <path or decision>
### Validation
- <check and actual result>
### Open questions and risks
- <owner, question, impact>
Limits
- This skill coordinates stages; it does not duplicate Natural analysis, requirements, implementation,
testing, security, or infrastructure procedures.
- Loop mechanics, gate queries, defect routing, and the engineering graph belong to
sifap-loop.
- Persona agents are optional aids. A stage agent remains accountable for the stage output and gate.
- No stage gate may claim success from an unrun check or unavailable artifact.
Output template
## SIFAP workshop status
**Stage:** archaeology | architecture | build | quality | operations
**Status:** ready | in-progress | blocked | complete
### Inputs
| Artifact | Present | Evidence |
| --- | --- | --- |
### Exit gate
| Criterion | Result | Evidence or blocker |
| --- | --- | --- |
### Handoff
- Next agent: <name or none>
- Context: <paths, decisions, questions>
Quality gate
1---2name: sifap-workshop-orchestration-23description: Coordinate the SIFAP modernization workshop through archaeology, architecture, build, quality, and operations stages with evidence gates, role handoffs, branch intent, and observable completion criteria. Use when starting a stage, checking readiness, or handing work to the next SIFAP stage agent.4---56# SIFAP workshop orchestration78Run the workshop as five evidence-gated stages while keeping reusable procedures in companion skills.910## When to invoke1112- "Start the SIFAP archaeology stage."13- "Check whether the team can hand off to architecture."14- "Coordinate the SIFAP build stage."15- "Prepare the final operations and review stage."1617## Inputs1819Use `$ARGUMENTS` to select one stage. If absent, infer the current stage only from artifacts that exist20in the target repository; otherwise ask the team to choose. Never create a branch or GitHub mutation21solely from an inferred stage.2223## Stage contract2425| Stage | Lead agent | Required input | Primary output | Exit gate |26| --- | --- | --- | --- | --- |27| Archaeology | `sifap-archaeologist` | Legacy corpus and scope | Inventory, dependencies, rule candidates, questions | Behavior claims cite inspected legacy evidence. |28| Architecture | `sifap-architect` | Approved rule candidates and scope | `REQ-NNN` specs, ADRs, modular-monolith plan | Requirements validate and unresolved meaning is not promoted. |29| Build | `sifap-builder` | Approved requirements, plan, and bounded slice | Modern code and equivalence tests | Focused tests and builds pass; drift is classified. |30| Quality | `sifap-quality` | Implemented slice and in-scope legacy files | Requirement verification, migration mapping, reconciliation numbers | Every requirement is verified and every in-scope file reconciles or is explicitly excluded. |31| Operations | `sifap-operations` | Verified implementation and operational scope | Hardening, reviewed issues/PRs, IaC evidence, runbook, retrospective | Human approvals and validation evidence are recorded. |3233## Procedure34351. Load `sifap-modernization-context` and the task-relevant references.362. Inspect the selected stage's required inputs; report missing inputs and stop before side effects.373. Invoke or hand off to the stage agent with objective, scope, evidence paths, decisions, and open38 questions. The stage agent loads its named companion skills before acting.394. Use `sifap-loop` to run the stage as a bounded correction loop and to evaluate its gate.405. Keep progress evidence-based; do not satisfy gates with arbitrary counts or generated placeholders.416. Evaluate every exit-gate item and identify blockers, unrun checks, and owner decisions.427. Hand off only the minimum durable context needed by the next stage.4344## Branch and mutation policy4546The workshop may use `spec/<NNN>-<feature>`, `impl/<NNN>-<feature>`, `infra/<component>`,47`docs/<topic>`, and `agent/<issue-NN>`. Confirm the target repository's real branch policy before branch48creation. Do not stage, commit, push, open an issue, assign an agent, review a PR, merge, deploy, or run49an infrastructure mutation without the applicable explicit approval.5051## Handoff contract5253```markdown54## SIFAP stage handoff5556**From:** <stage and agent>57**To:** <stage and agent>58**Status:** ready | blocked5960### Objective and scope61- <bounded outcome>6263### Evidence and decisions64- <path or decision>6566### Validation67- <check and actual result>6869### Open questions and risks70- <owner, question, impact>71```7273## Limits7475- This skill coordinates stages; it does not duplicate Natural analysis, requirements, implementation,76 testing, security, or infrastructure procedures.77- Loop mechanics, gate queries, defect routing, and the engineering graph belong to `sifap-loop`.78- Persona agents are optional aids. A stage agent remains accountable for the stage output and gate.79- No stage gate may claim success from an unrun check or unavailable artifact.8081## Output template8283```markdown84## SIFAP workshop status8586**Stage:** archaeology | architecture | build | quality | operations87**Status:** ready | in-progress | blocked | complete8889### Inputs90| Artifact | Present | Evidence |91| --- | --- | --- |9293### Exit gate94| Criterion | Result | Evidence or blocker |95| --- | --- | --- |9697### Handoff98- Next agent: <name or none>99- Context: <paths, decisions, questions>100```101102## Quality gate103104- [ ] The selected stage and bounded outcome are explicit.105- [ ] `sifap-modernization-context` was loaded before stage work.106- [ ] Required inputs exist and all behavior claims cite evidence.107- [ ] Exit criteria use actual validation rather than arbitrary output counts.108- [ ] No branch, GitHub, deployment, or infrastructure mutation occurred without approval.109- [ ] The handoff contains objective, scope, evidence, decisions, validation, and open questions.
paulasilvatech