Skip to content

Commit 3ae75a7

Browse files
authored
chore: migrate specs to openspec and update CLAUDE.md references (#53)
- Update CLAUDE.md to point to openspec/specs/ instead of docs/internal/ - Fix Architecture section (remove non-existent content/core/, add content/blocks/) - Add openspec/ to .gitignore (SDD artifacts are internal, not published)
1 parent 717ac38 commit 3ae75a7

2 files changed

Lines changed: 10 additions & 12 deletions

File tree

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,4 +44,5 @@ coverage/
4444
*.tgz
4545
.dwf/.cache/
4646
docs/internal
47+
openspec/
4748
.vercel

CLAUDE.md

Lines changed: 9 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ CLI tool that compiles developer rules into editor-specific config files (CLAUDE
1111

1212
## Architecture
1313

14-
- `content/core/` → tool-agnostic source of truth (workflows, skills, templates)
1514
- `content/rules/` → official rule files (Markdown), fetched from GitHub via `devw add`
16-
- `packages/cli/src/bridges/` → per-tool adapters that translate core → native format
15+
- `content/blocks/` → local prebuilt blocks installed via `devw add <block-id>`
16+
- `packages/cli/src/bridges/` → per-tool adapters that translate rules → native format
1717
- Bridges only translate. They do not add new intent or logic.
1818

1919
## Key commands
@@ -30,15 +30,12 @@ devw add --list # list available rules
3030

3131
## Specs (read before implementing)
3232

33-
- `docs/internal/CLI_SPEC.md` → v0.1 specification (COMPLETE)
34-
- `docs/internal/CLI_SPEC_v0.2.md` → v0.2 specification (COMPLETE)
35-
- `docs/internal/CLI_SPEC_v0.2.1.md` → v0.2.1 UX polish specification (COMPLETE)
36-
- `docs/internal/DOCS_SPEC.md` → Mintlify documentation spec (COMPLETE)
37-
- `docs/internal/WATCH_SPEC.md` → v0.3 watch mode specification (COMPLETE)
38-
- `docs/internal/PULL_SPEC.md` → v0.4 Pull rules specification (ABSORBED into `devw add`)
39-
- `docs/internal/DECISIONS.md` → accepted decisions (source of truth if conflict)
40-
- `docs/internal/` is gitignored — internal specs not published
41-
33+
- `openspec/specs/cli/spec.md` → CLI spec (commands, bridges, UI, registry) — current state
34+
- `openspec/specs/decisions/spec.md` → accepted decisions (source of truth if conflict)
35+
- `openspec/specs/docs/spec.md` → Mintlify documentation site spec
36+
- `openspec/specs/theme/spec.md` → design system for the landing page
37+
- `openspec/changes/pull-command/tasks.md``feat/pull-command` branch state (pending merge)
38+
- `openspec/` is gitignored — internal specs not published
4239

4340
If a decision is not in the specs, do not implement it. Propose a documentation change first.
4441

@@ -55,7 +52,7 @@ If you are on `main`, stop and create a branch before doing anything else.
5552

5653
## What NOT to do
5754

58-
- Do not add dependencies not listed in `docs/internal/CLI_SPEC.md` without asking.
55+
- Do not add dependencies not listed in `openspec/specs/cli/spec.md` without asking.
5956
- Do not create new documentation trees. Update existing docs instead.
6057
- Do not move files or rename directories unless explicitly instructed.
6158

0 commit comments

Comments
 (0)