Skip to main content
AI/MLWaterplanAI

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--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/plugins/ac-workflow/skills/ac-workflow/spec/SKILL.md -o .claude/skills/spec.md

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

/spec STAGE SPEC: STRICTLY FOLLOW ${CLAUDE_PLUGIN_ROOT}/agents/spec/{STAGE}.md using stage + spec path arguments.

Supported public stages

Primary stages:

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

Compatibility/internal stages may still exist (PLAN_REVIEW, VALIDATE, VALIDATE_INLINE, AMEND), but mux-ospec public flows should use the primary stage names above.

Spec rules

  • canonical external-spec path convention: .specs/specs/<YYYY>/<MM>/<branch>/<NNN>-<title>.md
  • modify AI Section only; never touch Human Section
  • every stage must commit every repo it changed
  • when both repos change: commit root first, then spec repo via resolver
  • stage closeout must include repo-scoped commit evidence (repo_scope, root_commit, spec_commit)

External spec routing

When specs are external, use:

  • ${CLAUDE_PLUGIN_ROOT}/scripts/spec-resolver.sh
  • ${CLAUDE_PLUGIN_ROOT}/scripts/external-specs.sh
  • ${CLAUDE_PLUGIN_ROOT}/scripts/lib/config-loader.sh