Skip to main content
AI/MLWaterplanAI

ac-workflow-spec

Core specification workflow engine. Supports CREATE, GATHER/RESEARCH, CONSOLIDATE, SUCCESS_CRITERIA, CONFIRM_SC, PLAN, IMPLEMENT, REVIEW, FIX, TEST, DOCUMENT, SENTINEL, SELF_VALIDATION, and compatibility stages.

Stars
31
Source
WaterplanAI/agentic-config
Updated
2026-05-25
Slug
WaterplanAI--agentic-config--ac-workflow-spec
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/WaterplanAI/agentic-config/HEAD/packages/pi-ac-workflow/skills/ac-workflow-spec/SKILL.md -o .claude/skills/ac-workflow-spec.md

Drops the SKILL.md into .claude/skills/ac-workflow-spec.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Spec Workflow Engine

/skill:ac-workflow-spec STAGE SPEC: strictly follow bundled stage instructions at ../../assets/agents/spec/{STAGE}.md.

Supported public stages

  • CREATE
  • GATHER (compatibility alias to RESEARCH)
  • RESEARCH
  • CONSOLIDATE
  • SUCCESS_CRITERIA
  • CONFIRM_SC
  • PLAN
  • IMPLEMENT
  • REVIEW
  • FIX
  • TEST
  • DOCUMENT
  • SENTINEL
  • SELF_VALIDATION

Compatibility/internal only: PLAN_REVIEW, VALIDATE, VALIDATE_INLINE, AMEND.

Repository and commit contract

  • default project convention: .specs/specs/<YYYY>/<MM>/<branch>/<NNN>-<title>.md
  • modify only AI section in spec files
  • each stage must commit every changed repo
  • if both repos changed, commit root repo first and spec repo second
  • include repo-scoped commit evidence in stage outputs: repo_scope, root_commit, spec_commit

Bundled assets

Use package-bundled assets:

  • ../../assets/agents/spec/{STAGE}.md
  • ../../assets/scripts/spec-resolver.sh
  • ../../assets/scripts/external-specs.sh
  • ../../assets/scripts/lib/config-loader.sh
  • ../../assets/scripts/lib/source-helpers.sh