Install
npx skillscat add ashokraj2011/singularityflow/sflow-code Install via the SkillsCat registry.
SKILL.md
Governed code
Output contract: Use governed inputs and pinned clarification; publish/show configured artifacts. For suggested actions, pair Shell with the returned Copilot command; honor commandGuidance. If absent, say "Copilot: no verified equivalent"; never invent a slash command.
Boundary: singularity-flow session current --json → ready/workId, cwd=repositoryPath; use CLI/workItemRoot paths; never $HOME.
- From the Boundary require
phase,phaseAgent.valid: true.singularity-flow status --json: match workId/currentPhase; requirephases[<phase>].generationPolicy.task: codeor legacyimplementation-summarywithout task. singularity-flow recover <WORK-ID> --phase <phase> --json: inspect blockers/actions, intent andtestExecution.phaseRepairRequired/working-treealone is no stop. Inspectgit status --porcelain=v1 --untracked-files=all, diffs and untracked content includingworkflow.json. Repair returned owned, in-scope authoring actions within an open intent;repair-repository-test-runnerrequiresCODE_DELIVERY_TEST_COMMAND_REQUIREDand source-scope repair. Untracked.sflow/results/**need no cleaning; preserve bytes. Tracked/staged reports still need review. Stop for protected/unrelated/unowned changes or lifecycle/authority blockers.generation.intent.consumed-changedrequires/sf-recoverreviewed rollover, never waiver.- Read Story context;
singularity-flow wm compose --phase <phase>. singularity-flow clarification status <phase> --json: Foroff, do not ask or record; continue. Forwhen-needed, ask and record only for material ambiguity; otherwise continue. Forrequired,ask_user, wait, record before mutation; stop if unavailable. Stage only{"responses":[...]}atgit rev-parse --git-path singularity-flow/clarification-responses/<phase>.json; never atsingularity/work-items/**/context/clarifications-*.json. Delete on success; never pass Markdown.singularity-flow story references verify --work-id <WORK-ID> --json: uselocalPath; refuse invalid/dirty. Checksingularity-flow revision status --json. Before authoring require an open intent; if absent runsingularity-flow phase begin <phase> --json, honoring adoption/confirmation. Consumed intent requires/sf-recover.- Implement code/tests, not README. Doc-comment APIs; tags are not docs. Exclude fixtures/docs/deletions/symlinks. In the planned product-source path:
// @clause:ORDER:REQ-001 how this change meets it(REQ|BEH|IFC|AC|CON); executable tests:// @ac:ORDER:AC-001above its test. Honor pinned test-only planned-claims opt-outs. - Compare
testExecution.commandsargv/cwd/adapter/report with manual tests. Python inference prefers.venv; pins remain unchanged. Repair runtime/dependencies with authorization. Run tests; no skip/list/dry-run/no-tests. Never edit protected configuration, disable hooks or fabricate results. In-scope declarations may repair inference. Forresolve-code-delivery-test-policyor unavailable inference, use/sf-recoverfor reviewed runner adoption. Refresh never changes this Story's pin; do not approve amendments here. - Run
singularity-flow phase draft-check <phase> --jsonandsingularity-flow phase prepublish <phase> --json. Correct every structured agent authoring finding in this Copilot turn; at most three changed fingerprints. Initial template is baseline; stop on an unchanged fingerprint only after correction. If blocking finding code and source code remain unchanged, stop this attempt despite other changes. Honorcorrection.class/sameTurn; never blindly delete markers, invent facts, use padding, invoke a nested model, or overwrite another producer.prepublish: readydoes not mean tests passed. - Publish once with configured producer/channel only when prepublish is
ready. On refusal reportrequiredTestExecution: command ID (not shell command), argv/cwd, exit, bounded stderr and guidance. Nonzero exit fails despite passing JUnit. Follow/sf-recover; proven runtime repair permits retry without source changes. Source mutation requires review/rollover when consumed. Pre-mutation failure retains intent. No blind retries; at most three repairs.ARTIFACT_AUTHORING_INCOMPLETE: recheck once, retry once. Never submit/approve. singularity-flow phase show <phase> --jsonreviews the artifact and handoff, including optional document view; stop. Never submit/approve.
TRP: singularity-flow explain test-recovery; risks → /sf-recover; no auto-waiver or false passes.