Skip to content

Commit 30c9a6b

Browse files
committed
chore: format
1 parent 39c9f6b commit 30c9a6b

File tree

7 files changed

+109
-18
lines changed

7 files changed

+109
-18
lines changed

.claude/commands/openspec/apply.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,20 +4,25 @@ description: Implement an approved OpenSpec change and keep tasks in sync.
44
category: OpenSpec
55
tags: [openspec, apply]
66
---
7+
78
<!-- OPENSPEC:START -->
9+
810
**Guardrails**
11+
912
- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
1013
- Keep changes tightly scoped to the requested outcome.
1114
- Refer to `openspec/AGENTS.md` (located inside the `openspec/` directory—run `ls openspec` or `openspec update` if you don't see it) if you need additional OpenSpec conventions or clarifications.
1215

1316
**Steps**
1417
Track these steps as TODOs and complete them one by one.
18+
1519
1. Read `changes/<id>/proposal.md`, `design.md` (if present), and `tasks.md` to confirm scope and acceptance criteria.
1620
2. Work through tasks sequentially, keeping edits minimal and focused on the requested change.
1721
3. Confirm completion before updating statuses—make sure every item in `tasks.md` is finished.
1822
4. Update the checklist after all work is done so each task is marked `- [x]` and reflects reality.
1923
5. Reference `openspec list` or `openspec show <item>` when additional context is required.
2024

2125
**Reference**
26+
2227
- Use `openspec show <id> --json --deltas-only` if you need additional context from the proposal while implementing.
2328
<!-- OPENSPEC:END -->

.claude/commands/openspec/archive.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,18 +4,23 @@ description: Archive a deployed OpenSpec change and update specs.
44
category: OpenSpec
55
tags: [openspec, archive]
66
---
7+
78
<!-- OPENSPEC:START -->
9+
810
**Guardrails**
11+
912
- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
1013
- Keep changes tightly scoped to the requested outcome.
1114
- Refer to `openspec/AGENTS.md` (located inside the `openspec/` directory—run `ls openspec` or `openspec update` if you don't see it) if you need additional OpenSpec conventions or clarifications.
1215

1316
**Steps**
17+
1418
1. Identify the requested change ID (via the prompt or `openspec list`).
1519
2. Run `openspec archive <id> --yes` to let the CLI move the change and apply spec updates without prompts (use `--skip-specs` only for tooling-only work).
1620
3. Review the command output to confirm the target specs were updated and the change landed in `changes/archive/`.
1721
4. Validate with `openspec validate --strict` and inspect with `openspec show <id>` if anything looks off.
1822

1923
**Reference**
24+
2025
- Inspect refreshed specs with `openspec list --specs` and address any validation issues before handing off.
2126
<!-- OPENSPEC:END -->

.claude/commands/openspec/proposal.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,18 @@ description: Scaffold a new OpenSpec change and validate strictly.
44
category: OpenSpec
55
tags: [openspec, change]
66
---
7+
78
<!-- OPENSPEC:START -->
9+
810
**Guardrails**
11+
912
- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
1013
- Keep changes tightly scoped to the requested outcome.
1114
- Refer to `openspec/AGENTS.md` (located inside the `openspec/` directory—run `ls openspec` or `openspec update` if you don't see it) if you need additional OpenSpec conventions or clarifications.
1215
- Identify any vague or ambiguous details and ask the necessary follow-up questions before editing files.
1316

1417
**Steps**
18+
1519
1. Review `openspec/project.md`, run `openspec list` and `openspec list --specs`, and inspect related code or docs (e.g., via `rg`/`ls`) to ground the proposal in current behaviour; note any gaps that require clarification.
1620
2. Choose a unique verb-led `change-id` and scaffold `proposal.md`, `tasks.md`, and `design.md` (when needed) under `openspec/changes/<id>/`.
1721
3. Map the change into concrete capabilities or requirements, breaking multi-scope efforts into distinct spec deltas with clear relationships and sequencing.
@@ -21,6 +25,7 @@ tags: [openspec, change]
2125
7. Validate with `openspec validate <id> --strict` and resolve every issue before sharing the proposal.
2226

2327
**Reference**
28+
2429
- Use `openspec show <id> --json --deltas-only` or `openspec show <spec> --type spec` to inspect details when validation fails.
2530
- Search existing requirements with `rg -n "Requirement:|Scenario:" openspec/specs` before writing new ones.
2631
- Explore the codebase with `rg <keyword>`, `ls`, or direct file reads so proposals align with current implementation realities.

AGENTS.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,21 @@
11
<!-- OPENSPEC:START -->
2+
23
# OpenSpec Instructions
34

45
These instructions are for AI assistants working in this project.
56

67
Always open `@/openspec/AGENTS.md` when the request:
8+
79
- Mentions planning or proposals (words like proposal, spec, change, plan)
810
- Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
911
- Sounds ambiguous and you need the authoritative spec before coding
1012

1113
Use `@/openspec/AGENTS.md` to learn:
14+
1215
- How to create and apply change proposals
1316
- Spec format and conventions
1417
- Project structure and guidelines
1518

1619
Keep this managed block so 'openspec update' can refresh the instructions.
1720

18-
<!-- OPENSPEC:END -->
21+
<!-- OPENSPEC:END -->

CLAUDE.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,21 @@
11
<!-- OPENSPEC:START -->
2+
23
# OpenSpec Instructions
34

45
These instructions are for AI assistants working in this project.
56

67
Always open `@/openspec/AGENTS.md` when the request:
8+
79
- Mentions planning or proposals (words like proposal, spec, change, plan)
810
- Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
911
- Sounds ambiguous and you need the authoritative spec before coding
1012

1113
Use `@/openspec/AGENTS.md` to learn:
14+
1215
- How to create and apply change proposals
1316
- Spec format and conventions
1417
- Project structure and guidelines
1518

1619
Keep this managed block so 'openspec update' can refresh the instructions.
1720

18-
<!-- OPENSPEC:END -->
21+
<!-- OPENSPEC:END -->

0 commit comments

Comments
 (0)