specify-workflow-pack

Files (73)

• SKILL.md
• openai.yaml · agents/
• SKILL.md · assets/bundled-skills/dispatching-parallel-agents/
• LICENSE.txt · assets/bundled-skills/playwright/
• NOTICE.txt · assets/bundled-skills/playwright/
• SKILL.md · assets/bundled-skills/playwright/
• openai.yaml · assets/bundled-skills/playwright/agents/
• playwright-small.svg · assets/bundled-skills/playwright/assets/
• playwright.png · assets/bundled-skills/playwright/assets/
• cli.md · assets/bundled-skills/playwright/references/
• workflows.md · assets/bundled-skills/playwright/references/
• playwright_cli.sh · assets/bundled-skills/playwright/scripts/
• SKILL.md · assets/bundled-skills/requesting-code-review/
• code-reviewer.md · assets/bundled-skills/requesting-code-review/
• SKILL.md · assets/bundled-skills/skill-creator/
• openai.yaml · assets/bundled-skills/skill-creator/agents/
• skill-creator-small.svg · assets/bundled-skills/skill-creator/assets/
• skill-creator.png · assets/bundled-skills/skill-creator/assets/
• license.txt · assets/bundled-skills/skill-creator/
• openai_yaml.md · assets/bundled-skills/skill-creator/references/
• generate_openai_yaml.py · assets/bundled-skills/skill-creator/scripts/
• init_skill.py · assets/bundled-skills/skill-creator/scripts/
• quick_validate.py · assets/bundled-skills/skill-creator/scripts/
• SKILL.md · assets/bundled-skills/subagent-driven-development/
• code-quality-reviewer-prompt.md · assets/bundled-skills/subagent-driven-development/
• implementer-prompt.md · assets/bundled-skills/subagent-driven-development/
• spec-reviewer-prompt.md · assets/bundled-skills/subagent-driven-development/
• CREATION-LOG.md · assets/bundled-skills/systematic-debugging/
• SKILL.md · assets/bundled-skills/systematic-debugging/
• condition-based-waiting-example.ts · assets/bundled-skills/systematic-debugging/
• condition-based-waiting.md · assets/bundled-skills/systematic-debugging/
• defense-in-depth.md · assets/bundled-skills/systematic-debugging/
• find-polluter.sh · assets/bundled-skills/systematic-debugging/
• root-cause-tracing.md · assets/bundled-skills/systematic-debugging/
• test-academic.md · assets/bundled-skills/systematic-debugging/
• test-pressure-1.md · assets/bundled-skills/systematic-debugging/
• test-pressure-2.md · assets/bundled-skills/systematic-debugging/
• test-pressure-3.md · assets/bundled-skills/systematic-debugging/
• SKILL.md · assets/bundled-skills/test-driven-development/
• testing-anti-patterns.md · assets/bundled-skills/test-driven-development/
• SKILL.md · assets/bundled-skills/verification-before-completion/
• SKILL.md · assets/bundled-skills/writing-plans/
• plan-document-reviewer-prompt.md · assets/bundled-skills/writing-plans/
• SKILL.md · assets/required-skills/brainstorming/
• LICENSE.txt · assets/required-skills/gh-address-comments/
• SKILL.md · assets/required-skills/gh-address-comments/
• openai.yaml · assets/required-skills/gh-address-comments/agents/
• github-small.svg · assets/required-skills/gh-address-comments/assets/
• github.png · assets/required-skills/gh-address-comments/assets/
• fetch_comments.py · assets/required-skills/gh-address-comments/scripts/
• LICENSE.txt · assets/required-skills/gh-fix-ci/
• SKILL.md · assets/required-skills/gh-fix-ci/
• openai.yaml · assets/required-skills/gh-fix-ci/agents/
• github-small.svg · assets/required-skills/gh-fix-ci/assets/
• github.png · assets/required-skills/gh-fix-ci/assets/
• inspect_pr_checks.py · assets/required-skills/gh-fix-ci/scripts/
• AGENTS.md.tmpl · assets/templates/
• brief-claude.md.tmpl · assets/templates/
• brief-codex.md.tmpl · assets/templates/
• brief-copilot.agent.md.tmpl · assets/templates/
• …and 13 more

SKILL.md (first lines)

# Specify Workflow Pack

## Overview

Use this skill to install or refresh a reusable brief-first, Specify-first workflow pack in a repository without copying your entire global skills setup into that repo.

This skill is for:

- bootstrapping a new repo with a standard governance and workflow layer
- syncing an existing repo to the current workflow pack
- validating whether a machine or repo is ready to use the workflow consistently
- keeping Codex, Claude Code, OpenCode, Copilot, and Antigravity aligned on the same repo-local process
- ensuring generated repos include mandatory fallback skills for `/brief` and `/workflow`

## Quick Start

1. Create a `workflow-pack.json` file in the target repository.
2. Run `scripts/install_workflow_pack.py` from this skill with the repo path and config path.
3. Review the generated diffs in the repo.
4. Run `scripts/doctor_workflow_pack.py` to validate the installation and local tool availability.
5. Start the first feature with `/brief "initial feature idea"`.
6. Run `/workflow <slug>` only after `BRIEF.md` is approved.

## Core Workflow

### 1. Inspect Before Installing

Before writing files, inspect the target repo for:

- existing `AGENTS.md`
- existing `CLAUDE.md`
- existing `.specify/` assets
- current CI commands and coverage rules
- supported workspaces and agent surfaces already present
- existing `skills/`, `.claude/skills/`, `.opencode/skills/`, or `.agents/skills/` fallbacks

If the repo already has governance files, compare them with the generated output before overwriting intentionally customized policy.

### 2. Prepare the Config

Use `workflow-pack.json` as the repo-local contract for the pack.

Read `references/config.md` for:

- required keys
- optional keys
- a complete example
- guidance on how to represent repo-specific commands, skills, and brief behavior

### 3. Install or Sync the Pack

Run:

```powershell
python <skill-dir>/scripts/install_workflow_pack.py --repo <repo-path> --config <repo-path>/workflow-pack.json
```

Use `--dry-run` first when you want to see which files will be written without changing the repo.

The installer renders repo-local files from the templates in `assets/templates/`, creates agent-native entrypoints for Codex, Claude Code, OpenCode, and GitHub Copilot, and copies required fallback skills into `skills/` plus the compatible mirror directories for other agents.

### 4. Validate the Result

Run:

```powershell
python <skill-dir>/scripts/doctor_workflow_pack.py --repo <repo-path> --config <repo-path>/workflow-pack.json
```

This validates:

- required generated files exist
- key tools are available on the machine
- the workflow entrypoint files exist where expected
- required skills are available globally or in the repo-local fallback mirrors
- the repo appears ready for multi-agent use

### 5. Review and Commit

After install or sync:

- inspect diffs carefully
- confirm CI commands still reflect reality
- confirm coverage threshold matches the repo configuration
- confirm repo-specific paths, artifact locations, and required skills are correct
- commit the generated changes in the target repo

## Bundled Resources

### scripts/

- `install_workflow_pack.py`: render or refresh the repo-local workflow pack from templates and fallback skills
- `doctor_workflow_pack.py`: validate that the repo and machine are ready to use the pack

### references/

- `config.md`: schema and examples for `workflow-pack.json`

### assets/

- `templates/`: renderable templates for AGENTS, constitution, Specify templates, and `/brief` and `/workflow` commands
- `required-skills/`: bundled repo-local fallbacks for mandatory workflow skills

## Notes

- Keep the skill global and the generated governance local to each repo.
- Do not copy unrelated global skills into repositories.
- Prefer config-driven repo installation over manual copy/paste.
- In generated repos, the precedence is global skill first, local fallback second, explicit failure last.
- The canonical kickoff is `/brief`, not `/workflow`.

From williamceccon/spec-driven-development-starter-pack, MIT.

More from williamceccon/spec-driven-development-starter-pack