chore: consolidate spec/agent tooling and add skill mirror generation - #453
Merged
Merged
Conversation
Move specs/ content into docs/ to consolidate all project documentation under a single directory. Remove specs/ entirely, merge specs/AGENTS.md into top-level AGENTS.md, and update all path references in skills, constitution, templates, and module specs.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR consolidates the project’s spec/agent documentation and workflow tooling under docs/ and .agents/, removes the legacy specs/ + Spec-Kit scaffolding, and introduces generation of Claude Code “skill mirror” files.
Changes:
- Remove the legacy
specs/SSOT and migrate module/spec documentation intodocs/modules/(plus new architecture, data-model, code-style, and change-proposal docs). - Consolidate agent guidance into top-level
AGENTS.md, reframe workflow arounddocs/changes/, and simplify.agents/skills/to a smaller curated set. - Add
.agents/tooling/generate_skill_mirrors.pyand commit generated.claude/skills/*mirrors, with.gitignoreupdated to keep mirrors tracked.
Reviewed changes
Copilot reviewed 44 out of 93 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| specs/README.md | Removes legacy specs SSOT README (specs/ directory retired). |
| specs/features/README.md | Removes legacy feature-spec workflow doc under specs/. |
| specs/AGENTS.md | Removes legacy agent behavior rules under specs/. |
| docs/modules/vm-interface/spec.md | Adds vm-interface module SSOT under docs/. |
| docs/modules/tools/spec.md | Updates cross-reference links to new docs layout. |
| docs/modules/tests/spec.md | Updates cross-reference links (including AGENTS path). |
| docs/modules/singlepass/spec.md | Updates data-model reference to local file. |
| docs/modules/rust-bindings/spec.md | Adds rust-bindings module SSOT under docs/. |
| docs/modules/runtime/spec.md | Adds runtime module SSOT under docs/. |
| docs/modules/README.md | Adds module index for docs/modules/. |
| docs/modules/platform/spec.md | Adds platform module SSOT under docs/. |
| docs/modules/platform/data-model.md | Adds platform module data model doc. |
| docs/modules/host/spec.md | Adds host module SSOT under docs/. |
| docs/modules/host/data-model.md | Adds host module data model doc. |
| docs/modules/evm/spec.md | Adds evm module SSOT under docs/. |
| docs/modules/evm/data-model.md | Adds evm module data model doc. |
| docs/modules/compiler/spec.md | Fixes archived-spec cross-reference path after docs move. |
| docs/modules/common/spec.md | Adds common module SSOT under docs/. |
| docs/modules/cli/spec.md | Adds cli module SSOT under docs/. |
| docs/modules/cli/data-model.md | Adds cli module data model doc. |
| docs/modules/action/spec.md | Adds action module SSOT under docs/. |
| docs/data-model/README.md | Adds global data model doc (shared types overview). |
| docs/code-style/README.md | Adds coding style guide under docs/. |
| docs/changes/template.md | Adds full change proposal template under docs/changes/. |
| docs/changes/template-light.md | Adds light change proposal template under docs/changes/. |
| docs/changes/README.md | Adds change-proposal process documentation. |
| docs/architecture/README.md | Adds high-level architecture documentation under docs/. |
| docs/_archive/README.md | Updates archive notes to point to docs/changes/ workflow. |
| docs/_archive/2026-04/update-evm-memory-block-precheck/tasks.md | Adds archived change task list. |
| docs/_archive/2026-04/update-evm-memory-block-precheck/specs/evm-jit/spec.md | Adds archived delta spec for evm-jit. |
| docs/_archive/2026-04/update-evm-memory-block-precheck/proposal.md | Updates archived proposal paths to docs/_archive locations. |
| docs/_archive/2026-03/add-evm-jit-fallback/tasks.md | Adds archived change task list. |
| docs/_archive/2026-03/add-evm-jit-fallback/specs/evm-jit-fallback/spec.md | Adds archived delta spec for JIT fallback. |
| docs/_archive/2026-03/add-evm-jit-fallback/specs/evm-execution/spec.md | Adds archived delta spec for execution semantics. |
| docs/_archive/2026-03/add-evm-jit-fallback/proposal.md | Adds archived proposal doc. |
| docs/_archive/2026-03/add-evm-jit-fallback/design.md | Adds archived design doc. |
| docs/_archive/2026-02/add-jit-suitability-checker/tasks.md | Adds archived change task list. |
| docs/_archive/2026-02/add-jit-suitability-checker/specs/evm-jit/spec.md | Adds archived delta spec for JIT suitability. |
| docs/_archive/2026-02/add-jit-suitability-checker/proposal.md | Adds archived proposal doc. |
| docs/_archive/2026-02/add-jit-suitability-checker/design.md | Adds archived design doc. |
| docs/_archive/2026-02/add-clz-opcode/tasks.md | Adds archived change task list. |
| docs/_archive/2026-02/add-clz-opcode/specs/evm-jit/spec.md | Adds archived delta spec for CLZ JIT support. |
| docs/_archive/2026-02/add-clz-opcode/specs/evm-execution/spec.md | Adds archived delta spec for CLZ execution. |
| docs/_archive/2026-02/add-clz-opcode/proposal.md | Adds archived proposal doc. |
| docs/_archive/2026-01/add-evmc-vm-interface-lib/tasks.md | Adds archived change task list. |
| docs/_archive/2026-01/add-evmc-vm-interface-lib/proposal.md | Adds archived proposal doc. |
| AGENTS.md | Consolidates agent guidance and updates workflow + skill mirror generation instructions. |
| .specify/templates/tasks-template.md | Removes legacy Spec-Kit task template. |
| .specify/templates/spec-template.md | Removes legacy Spec-Kit spec template. |
| .specify/templates/plan-template.md | Removes legacy Spec-Kit plan template. |
| .specify/templates/checklist-template.md | Removes legacy Spec-Kit checklist template. |
| .specify/templates/agent-file-template.md | Removes legacy Spec-Kit agent context template. |
| .specify/scripts/bash/setup-plan.sh | Removes legacy Spec-Kit planning setup script. |
| .specify/scripts/bash/common.sh | Removes legacy Spec-Kit shared bash helpers. |
| .specify/scripts/bash/check-worktree.sh | Removes legacy Spec-Kit worktree check script. |
| .specify/scripts/bash/check-prerequisites.sh | Removes legacy Spec-Kit prereq checker. |
| .specify/memory/constitution.md | Updates constitution to new docs/changes + skills SSOT model; updates last-updated date. |
| .gitignore | Ignores .claude/* but keeps .claude/skills/ mirrors tracked. |
| .claude/skills/dtvm-perf-profile/SKILL.md | Adds generated Claude Code mirror for dtvm-perf-profile skill. |
| .claude/skills/dmir-compiler-analysis/SKILL.md | Adds generated Claude Code mirror for dmir-compiler-analysis skill. |
| .claude/skills/dev-workflow/SKILL.md | Adds generated Claude Code mirror for dev-workflow skill. |
| .claude/skills/archive/SKILL.md | Adds generated Claude Code mirror for archive skill. |
| .agents/tooling/generate_skill_mirrors.py | Adds generator script (and --check mode) for Claude skill mirrors. |
| .agents/skills/speckit-taskstoissues/SKILL.md | Removes legacy speckit-taskstoissues skill. |
| .agents/skills/speckit-tasks/SKILL.md | Removes legacy speckit-tasks skill. |
| .agents/skills/speckit-specify/SKILL.md | Removes legacy speckit-specify skill. |
| .agents/skills/speckit-plan/SKILL.md | Removes legacy speckit-plan skill. |
| .agents/skills/speckit-implement/SKILL.md | Removes legacy speckit-implement skill. |
| .agents/skills/speckit-dev-workflow/SKILL.md | Removes legacy speckit-dev-workflow skill. |
| .agents/skills/speckit-constitution/SKILL.md | Removes legacy speckit-constitution skill. |
| .agents/skills/speckit-clarify/SKILL.md | Removes legacy speckit-clarify skill. |
| .agents/skills/speckit-checklist/SKILL.md | Removes legacy speckit-checklist skill. |
| .agents/skills/speckit-archive/SKILL.md | Removes legacy speckit-archive skill. |
| .agents/skills/speckit-analyze/SKILL.md | Removes legacy speckit-analyze skill. |
| .agents/skills/README.md | Rewrites skills README to reflect new SSOT and curated skill set. |
| .agents/skills/dev-workflow/SKILL.md | Adds new dev-workflow skill definition. |
| .agents/skills/archive/SKILL.md | Adds new archive skill definition. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
⚡ Performance Regression Check Results✅ Performance Check Passed (interpreter)Performance Benchmark Results (threshold: 25%)
Summary: 194 benchmarks, 0 regressions ✅ Performance Check Passed (multipass)Performance Benchmark Results (threshold: 25%)
Summary: 194 benchmarks, 0 regressions |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Move specs/ content into docs/ to consolidate all project documentation under a single directory. Remove specs/ entirely, merge specs/AGENTS.md into top-level AGENTS.md, and update all path references in skills, constitution, templates, and module specs.
1. Does this PR affect any open issues?(Y/N) and add issue references (e.g. "fix #123", "re #123".):
2. What is the scope of this PR (e.g. component or file name):
3. Provide a description of the PR(e.g. more details, effects, motivations or doc link):
4. Are there any breaking changes?(Y/N) and describe the breaking changes(e.g. more details, motivations or doc link):
5. Are there test cases for these changes?(Y/N) select and add more details, references or doc links:
6. Release note