Skip to content

README.md

Latest commit

 

History

History
155 lines (117 loc) · 7.83 KB

README.md

File metadata and controls

155 lines (117 loc) · 7.83 KB

SpecDD Agent Plugins

Reusable SpecDD skills for agent development workflows.

This repository is the source-of-truth build repo for product-specific SpecDD agent plugins and the SpecDD Agent Skills standard distribution. It does not replace the specdd CLI or install framework files. Generated outputs help agents read a target project's active .specdd/bootstrap.md chain, resolve local spec authority, and work through orientation, explanation, planning, implementation, review, testing, tracing, documentation, refactoring, debugging, and risk assessment.

Repositories

Plugin output repositories:

Agent Skills standard distribution:

Generated output repositories are checked out as submodules under plugins.

Supported Agents

Agent Output repo Install path Validation
Codex specdd/plugin-codex codex plugin marketplace add specdd/specdd --ref main, then codex plugin add specdd@specdd make test runs the Codex plugin validator.
Claude Code specdd/plugin-claude claude plugin marketplace add specdd/specdd, then claude plugin install specdd@specdd make test runs claude plugin validate plugins/claude.
GitHub Copilot specdd/plugin-copilot Install each skill with gh skill install specdd/plugin-copilot <skill>. make test runs gh skill publish plugins/copilot --dry-run.
Junie specdd/plugin-junie Copy skills/* into ~/.junie/skills/ or .junie/skills/; gh skill install --agent junie is a secondary tracked install path. Built and checked by make build and make check; no Makefile validator until a stable native validator exists.
Cline specdd/plugin-cline Copy skills/* into ~/.cline/skills/ or .cline/skills/; gh skill install --agent cline is a secondary tracked install path. make test runs the project-local Cline validator.
Antigravity specdd/plugin-antigravity agy plugin install https://github.com/specdd/plugin-antigravity.git; marketplace install can be added when an Antigravity marketplace is configured. make test runs agy plugin validate plugins/antigravity.

Agent Skills Standard

Agent Skills is an open standard for distributing reusable agent skills. The specdd/agentskills repository is generated from this source tree as a generic standards-compliant skill distribution.

Source Layout

Skills

  • specdd-adopt: create or improve .sdd specs.
  • specdd-orient: read bootstraps, inspect repo shape, and get ready for tasks.
  • specdd-explain: explain specs in succinct human language.
  • specdd-plan: plan a change under existing specs.
  • specdd-do: implement a change under existing specs.
  • specdd-review: review changes against specs.
  • specdd-task: find, add, organize, and verify SpecDD tasks.
  • specdd-trace: map specs to code, tests, and changed files.
  • specdd-test: derive focused tests from governing specs.
  • specdd-refactor: change structure without changing specified behavior.
  • specdd-debug: diagnose bugs against the governing contract.
  • specdd-docs: turn specs into user or developer documentation.
  • specdd-risk: classify change risk before work starts.

Development

Before changing this repository, read .specdd/bootstrap.md and repo.sdd. The project spec grants repository-wide write authority but requires generated output behavior to defer to the target project's own SpecDD bootstrap chain.

Build generated outputs:

make build

Initialize generated output submodules after cloning:

make modules-init

Check that generated outputs are current:

make check

Build generated outputs, check freshness, and run available target validators:

make test

make test validates plugins/codex with the Codex plugin validator, plugins/claude with claude plugin validate, plugins/copilot with gh skill publish --dry-run, plugins/cline with the project-local Cline validator, plugins/antigravity with agy plugin validate, and plugins/agentskills with the project-local Agent Skills validator. Junie is built and checked, but it does not have a Makefile validator until a stable native validator exists.

Release generated output repositories:

make modules-release

make modules-release runs the full test target, asks for confirmation, then commits and pushes changed output submodules listed in the Makefile GENERATED_REPOS variable. Outputs with no generated changes are skipped before version, tag, commit, or push operations. Classic plugin outputs are listed in PLUGIN_REPOS; the Agent Skills standard distribution is listed in AGENT_SKILLS_REPOS.

Discard local generated output changes and pull the latest generated repositories:

make modules-reset

make modules-reset resets and cleans each generated output submodule to origin/main.

The Codex validator defaults to $CODEX_HOME/skills/.system/plugin-creator/scripts/validate_plugin.py, with CODEX_HOME defaulting to ~/.codex. Antigravity defaults to $HOME/.local/bin/agy. Override CODEX_PLUGIN_VALIDATOR, CLAUDE, GH, CLINE_VALIDATOR, AGENTSKILLS_VALIDATOR, AGY, NODE, or PYTHON when using different local tool paths.

Legal

Copyright (c) 2026 Matīss Treinis and SpecDD contributors

SpecDD is licensed under the Apache License 2.0. SpecDD™ is a trademark of Matīss Treinis.