Agent skill
workflow-start
Install this agent skill to your Project
npx add-skill https://github.com/leeovery/agentic-workflows/tree/main/skills/workflow-start
SKILL.md
Unified workflow entry point. Discovers state, shows all active work, and routes to start or continue skills.
⚠️ ZERO OUTPUT RULE: Do not narrate your processing. Produce no output until a step or reference file explicitly specifies display content. No "proceeding with...", no discovery summaries, no routing decisions, no transition text. Your first output must be content explicitly called for by the instructions.
Instructions
Follow these steps EXACTLY as written. Do not skip steps or combine them.
CRITICAL: This guidance is mandatory.
- After each user interaction, STOP and wait for their response before proceeding
- Never assume or anticipate user choices
- Complete each step fully before moving to the next
Output the next fenced block as a code block:
──────────────────────────────────────────────────────────────────────
___ _____________ __________________
/ | / ____/ ____/ | / /_ __/ _/ ____/
/ /| |/ / __/ __/ / |/ / / / / // /
/ ___ / /_/ / /___/ /| / / / _/ // /___
/_/ |_\____/_____/_/ |_/ /_/ /___/\____/
_ ______ ____ __ __ ________ ____ _ _______
| | / / __ \/ __ \/ //_// ____/ / / __ \ | / / ___/
| | /| / / / / / /_/ / ,< / /_ / / / / / / | /| / /\__ \
| |/ |/ / /_/ / _, _/ /| |/ __/ / /___/ /_/ /| |/ |/ /___/ /
|__/|__/\____/_/ |_/_/ |_/_/ /_____/\____/ |__/|__//____/
──────────────────────────────────────────────────────────────────────
Agentic engineering workflows — from idea to implementation.
──────────────────────────────────────────────────────────────────────
Step 0: Initialisation
Load casing-conventions.md and follow its instructions as written.
Run migrations — this is mandatory. You must complete it before proceeding.
Invoke the /workflow-migrate skill and follow its instructions exactly — if it issues a STOP gate, you must stop.
→ Proceed to Step 1.
Step 1: Run Discovery
!node .claude/skills/workflow-start/scripts/discovery.cjs
If the above shows a script invocation rather than discovery output, the dynamic content preprocessor did not run. Execute the script before continuing:
node .claude/skills/workflow-start/scripts/discovery.cjs
Parse the output to understand the current workflow state:
From epics section:
work_units— name, active_phases (list of phase names with artifacts)
From features section:
work_units— name, next_phase, phase_label
From bugfixes section:
work_units— name, next_phase, phase_label
From completed/cancelled arrays:
- Non-active work units with name, work_type, status, last_phase
completed_count,cancelled_count
From inbox section (only present when inbox items exist):
ideas— slug, date, title for each ideabugs— slug, date, title for each bugidea_count,bug_count,total_count
From state section:
- Counts for each work type,
has_any_workflag has_inbox,inbox_count
→ Proceed to Step 2.
Step 2: Check State
If state.has_any_work is false
Load empty-state.md and follow its instructions as written.
Otherwise
→ Proceed to Step 3.
Step 3: Display and Route
Load active-work.md and follow its instructions as written.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
update-workflow-explorer
Audit and update workflow-explorer.html flowcharts to match the current codebase logic. Reads all command, skill, and agent source files, compares against the 4 data structures in the HTML file, reports drift, and applies updates. Use when workflow logic has changed and the explorer needs syncing.
create-output-format
Scaffold a new planning output format adapter. Creates a format directory with all required files implementing the output format contract.
continue-feature
workflow-review-entry
workflow-planning-process
workflow-scoping-entry
Didn't find tool you were looking for?