workflow-optimizer
Determine current position in the 8-layer SDD workflow and recommend prioritized next steps, parallel-work opportunities, and progress metrics. Use after completing an artifact or when unsure what to create next.
How do I install this agent skill?
npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill workflow-optimizerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
No files were provided for analysis, resulting in no security findings.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/1 file flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
workflow-optimizer
Purpose
Guide a user through the 8-layer SDD workflow (BRD → PRD → EARS → BDD → ADR → SPEC → TDD → IPLAN → Code). It locates the current position from completed artifacts, recommends prioritized next steps with rationale, surfaces work that can proceed in parallel, and reports progress — removing the friction of manually deciding what to build next.
When to Use
Use workflow-optimizer when:
- You just completed an artifact and need next-step guidance.
- You are starting documentation and want a workflow overview.
- You want to find parallel-work opportunities or a progress report.
Do not use it to pick a skill for a specific task (use
../skill-recommender/SKILL.md), to gather project context (use
../context-analyzer/SKILL.md), or to validate artifacts (use
../trace-check/SKILL.md or ../quality-advisor/SKILL.md).
Behavior
Given a project_root (and optionally a just-completed artifact and a focus
filter), the skill:
- Analyzes project state — discovers artifacts and extracts status (Draft, In Review, Approved, Superseded, Deprecated) from Document Control, producing counts by type.
- Determines workflow position — maps artifacts to layers 1–8 (each with a single-layer prerequisite per the cumulative chain), marking layers as completed, in-progress, ready, or blocked, and computes a progress percentage.
- Identifies required next steps — uses the dependency chain to list mandatory next artifacts, prioritized P0/P1/P2 with rationale and what each unblocks.
- Finds parallel opportunities — independent BRD/PRD tracks, ADRs that can be drafted concurrently, and BDD scenarios that can start once EARS requirements exist; notes items blocked by missing upstream layers.
- Calculates progress metrics — per-layer status and the critical path (EARS → BDD → ADR → SPEC → TDD → IPLAN).
- Generates recommendations — concrete next actions naming the layer skill
to run (e.g.
../doc-ears/SKILL.md), parallel suggestions, blocked items with unblock paths, and a progress summary.
Related Resources
- Layer registry (layers & prerequisites):
framework/registry/LAYER_REGISTRY.yaml - Traceability:
framework/governance/TRACEABILITY.md - Layer skills:
../doc-brd/SKILL.md…../doc-iplan/SKILL.md - Related skills:
../context-analyzer/SKILL.md·../skill-recommender/SKILL.md·../doc-flow/SKILL.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/vladm3105/aidoc-flow-framework/workflow-optimizer">View workflow-optimizer on skillZs</a>