WORKFLOW

A set of project rules for moving a software change through defined stages: writing a specification, planning, coding, and review. It keeps task progress and decisions in files on disk.

In plain words
What is it for?
Use it for non-trivial coding tasks that need a repeatable workflow, shared task state, debugging, review, pausing, or resuming.
Why use it?
It helps teams keep requirements, acceptance checks, steps, and paused work aligned throughout a change.

Cursor rule for Cursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/bonnguyenitc/specship/workflow
Clone the repo
git clone --depth 1 https://github.com/bonnguyenitc/specship

Made for: Cursor.

Per session 446 This file is loaded in full into every session.
When invoked 446 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00446 $0.00446
Opus 5 $0.00223 $0.00223
Sonnet 5 $0.00089 $0.00089
Haiku 4.5 $0.00045 $0.00045

Measured 2d ago against content hash 923165e344b8, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

WORKFLOW scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/WORKFLOW.mdc · 27 lines

What it actually says

For any non-trivial change, follow .cursor/skills/WORKFLOW.md and the per-stage playbooks in .cursor/skills/ss-<stage>/SKILL.md (spec → plan → coding → review; debug as needed; ss-ship = autopilot that runs spec → plan → coding → review end-to-end from a feature request; ss-resume-task = re-entry that locates an in-progress/paused task, reports where it stands, and resumes the right stage; ss-pause-task / ss-archive-task = lifecycle skills that shelve a task as paused or move it into tasks/archive/, keeping pipeline state intact).

Rules:

  • Every skill folder is ss--prefixed; the stage:/artifacts: values in task.md are not (spec, plan, coding, review, debug, done).
  • Maintain shared state in tasks/TASK-<ID>/: read task.md first, update it last.
  • Keep IDs stable (R# requirement, AC# acceptance criterion, S# step, BUG#); never renumber. ss-coding ticks S# in plan.md; ss-review ticks AC# in spec.md.
  • Timestamp every log entry as YYYY-MM-DD HH:MM +TZ (get it from date, don't guess).
  • Follow docs/onboarding/how-to-code.md for code style and placement; run ss-explore-source to generate docs/onboarding/* if missing.
  • Only the pipeline stages and lifecycle skills (ss-pause-task/ss-archive-task/ss-resume-task) write to tasks/. Ask the user before advancing stages (under ss-ship, auto-advance instead — stop only on blockers).
  • Don't run git add / commit / push unless asked.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 27 lines · 446 tokens per session scan A 923165e344b8

Subscribe to this mod's changes

WORKFLOW is a cursor rule published in the GitHub repository bonnguyenitc/specship (2 stars, last pushed 24d ago), licensed MIT. It adds 446 tokens to every session, about $0.0022 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other cursor rules, from other repositories

queue

A visible, editable Markdown work queue that agents drain autonomously — one task at a time or fanned out across parallel git worktrees — running each as a quick chore or the full feature-chain (design→prd→tdd→refine) with no user input. Use to queue, prioritize, stop/restart, seed from in-memory items, or…

victusfate/scaffold · 81 tokens

resume

Resume a checkpointed session from the pushed handoff and continue where it left off. Use on "resume", "pick up where I left off", "continue from the handoff", or starting cold on another device — pulls, reads .pause/handoff.md, and keeps going.

victusfate/scaffold · 57 tokens

github-issue-creation

Instructions for creating well-structured GitHub issues following best practices and project conventions.

steipete/agent-rules · 15 tokens

agents

Enforce AGENTS.md (feature chain, MVD, PR workflow).

victusfate/scaffold · 106 tokens

code-refiner

Composite review-and-fix for the current diff — run the correctness review (validate) and structural-quality review (simplify) in parallel, merge their findings, then apply all fixes in a single serial pass and re-verify. Supports --effort, --fix, --comment. For a full-repo survey use /audit.

victusfate/scaffold · 67 tokens

statusline

Turn the usage statusLine on or off (model + context% + 5-hour usage% in every project) without editing config by hand. Runs bin/install-statusline.sh, which installs the script to /.claude and merges the setting without clobbering other keys. Opt-in, global, run once per machine; /statusline off disables it.

victusfate/scaffold · 74 tokens