sflow-start
Explicitly choose a remote base, intake source, and workflow; create and publish the canonical Story branch.
Files1
View on GitHubSKILL.mdplugin/skills/sflow-start/SKILL.md
GitHubStart work
<!-- sflow-copilot-pause -->First require an explicit Work ID, then run singularity-flow workspace branches --entry --intake --work-id <WORK-ID> --for-agent --json once. It checks pause before Git and combines workspace/build/clean-tree/catalog facts. If paused, native Copilot; only offer /sf-pause off, never resume implicitly. Reuse the packet; no separate pause/workspace/version/status/catalog calls. Ask explicit choices; creation still revalidates live authority.
Output contract: Explicit choices; no preselection; preserve errors/artifacts/actions. Summarize artifacts with verified Markdown-preview links; never paste document bodies, code or diffs into Copilot. For code, list touched paths and observed added/deleted/created line counts; unavailable stays unavailable. Use existing evidence, not extra calls solely for display. Summaries, links and opened previews are not human review or approval. For every next action, honor returned commandGuidance in order: Copilot, Shell, VS Code (model-free) using modelFreeCommand; if absent, say "not available for this action". Missing Copilot: "no verified equivalent". Never invent routes.
Boundary: no Story required; reuse entry repositoryPath after its workspace/clean-tree checks. Refuse absent/unready selections; never search $HOME/parents. Use exact CLI-returned paths. repositoryPath is command cwd, not a prefix for absolute file paths. Never rebase paths or strip .git/worktrees. Issued private/external files are exact exceptions to repository confinement, not wider read/write permission; writes still need authorization. Resolve relative paths only against their declared base. On failure, preserve the path and error; never search or recreate it.
- Use the entry once.
workspace-repair-required: follow/sf-workspacefor its exact selected repository; re-enter only after repair.worktree-review-required: preserve and list itschanges; do not create a Story. The person commits, ignores, moves or lands them (/sf-adhoc), then reruns/sf-start. Use itsrepositoryPath; never search for a checkout. - Unless
existingWork.statusisnew, route existing IDs to/sf-sessionorsingularity-flow resume <WORK-ID>, never restart. Unreachable/unknown repositories are not new IDs. - The catalog and selected-base preflight check required members together; no workspace-wide status rescan. Repair returned missing-member failures explicitly. Authority failure: Shell
singularity-flow workspace reinitialize --dry-run --json, Copilot/sf-admin; neverinitfor an absent local workflow file. - Choose
<BASE>explicitly. Ifintake.workflowCatalogScopeis notapproved-configuration, run step 6 without--work-type. Choose<WORKFLOW>from exact-baseintake.storyWorkflows. - Collect Jira/manual outcome, criteria, scope, risks, documents. References need ID, credential-free URL and branch:
--reference-repository ID=URL --reference-branch ID=BRANCH. Pass--jira/--story-file; pair document inputs with their name flags. Never search for inputs. - Choose baseline (
reuse, optional reviewedrun,defer), tests (changed-and-affected,all-configured) and gates (hard,soft) separately. Soft needs exact human coverage-risk review, reason/expiry; tests/integrity stay hard. Runsingularity-flow workspace branches --json --intake --preflight-story <WORK-ID> --from-branch <BASE> --work-type <WORKFLOW> --selected-base-only --mint-intake-receipt --readiness-baseline <CHOICE> --test-execution-mode <MODE> --gate-mode <GATES>. Missing tests/setup never block creation or imply a pass. No implicit installs/tests; baselines use/sf-ready. World Model/AST/models/telemetry: advisory. Never upgrade configuration here.preflight.storyBranchis the branch start creates; a person's own name goes to both as--ref <BRANCH>. - Start with identical base/workflow/baseline/test/gate flags; add returned
--intake-receipt.targetUrl: requiredneeds--target-url; pass arecommendedone when given. Withoutask_user, use step 8 or stop; keep hard gates unless explicitly selected otherwise. - Without
ask_user, use pinned choices:singularity-flow choices begin start <WORK-ID> --for-agent --json,singularity-flow choices answer <TOKEN>, pass--selection-receipt <TOKEN>(15-minute, single-use). - Show readiness;
/sf-next. Pending tests: Copilot/sf-test-setup; Shellsingularity-flow capability test-setup --json. Tests run later; publish needs evidence.
TRP: singularity-flow explain test-recovery; acceptance needs native evidence/live human review. Never answer approval cards; use returned actions.