@ancleto/spec 0.6.2 → 0.6.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +184 -91
  2. package/agents/coder.md +11 -11
  3. package/agents/documenter.md +27 -27
  4. package/agents/orchestrator.md +8 -8
  5. package/agents/reviewer.md +13 -13
  6. package/agents/spec-writer.md +11 -11
  7. package/agents/technical-discovery.md +5 -5
  8. package/agents/technical-seed-writer.md +1 -1
  9. package/agents/tester.md +9 -9
  10. package/commands/{opsx-apply.md → cleto-apply.md} +9 -9
  11. package/commands/{opsx-archive.md → cleto-archive.md} +16 -16
  12. package/commands/{opsx-bulk-archive.md → cleto-bulk-archive.md} +8 -8
  13. package/commands/{opsx-continue.md → cleto-continue.md} +8 -8
  14. package/commands/{opsx-explore.md → cleto-explore.md} +9 -9
  15. package/commands/{opsx-ff.md → cleto-ff.md} +10 -12
  16. package/commands/{opsx-new.md → cleto-new.md} +12 -14
  17. package/commands/{opsx-onboard.md → cleto-onboard.md} +45 -57
  18. package/commands/{opsx-propose.md → cleto-propose.md} +11 -13
  19. package/commands/{opsx-recall.md → cleto-recall.md} +6 -6
  20. package/commands/{opsx-sync.md → cleto-sync.md} +6 -6
  21. package/commands/{opsx-verify.md → cleto-verify.md} +5 -5
  22. package/package.json +2 -2
  23. package/skills/{openspec-apply → ancleto-apply}/SKILL.md +6 -6
  24. package/skills/{openspec-archive → ancleto-archive}/SKILL.md +10 -10
  25. package/skills/{openspec-bulk-archive → ancleto-bulk-archive}/SKILL.md +8 -8
  26. package/skills/{openspec-continue → ancleto-continue}/SKILL.md +7 -7
  27. package/skills/{openspec-explore → ancleto-explore}/SKILL.md +6 -6
  28. package/skills/{openspec-ff → ancleto-ff}/SKILL.md +4 -4
  29. package/skills/{openspec-new → ancleto-new}/SKILL.md +6 -6
  30. package/skills/{openspec-onboard → ancleto-onboard}/SKILL.md +20 -20
  31. package/skills/{openspec-propose → ancleto-propose}/SKILL.md +6 -6
  32. package/skills/{openspec-recall → ancleto-recall}/SKILL.md +3 -3
  33. package/skills/{openspec-sync-specs → ancleto-sync-specs}/SKILL.md +7 -7
  34. package/skills/ancleto-upgrade/SKILL.md +11 -13
  35. package/skills/ancleto-upgrade/references/templates.md +1 -1
  36. package/skills/{openspec-verify → ancleto-verify}/SKILL.md +5 -5
  37. package/skills/{openspec-workflow → ancleto-workflow}/SKILL.md +19 -19
  38. package/skills/triage-clarifier/SKILL.md +1 -1
  39. package/src/cli/index.js +40 -20
  40. package/templates/AGENTS.md +4 -4
  41. package/templates/PRODUCT.md +1 -1
@@ -21,7 +21,7 @@ Read `AGENTS.md` at the repo root for project-specific conventions, tech stack,
21
21
 
22
22
  Review completed work using one of these approved inputs:
23
23
 
24
- - An active OpenSpec change in `openspec/changes/{change-name}/`
24
+ - An active aspec change in `aspec/changes/{change-name}/`
25
25
  - A direct implementation request explicitly approved by `@orchestrator`
26
26
  - A direct test-only request explicitly approved by `@orchestrator`
27
27
 
@@ -29,15 +29,15 @@ Your job is to identify correctness issues, scope deviations, convention violati
29
29
 
30
30
  ## Input Modes
31
31
 
32
- ### 1. OpenSpec Change
32
+ ### 1. aspec Change
33
33
 
34
- If an approved OpenSpec change exists, review against:
34
+ If an approved aspec change exists, review against:
35
35
 
36
- - relevant delta specs under `openspec/changes/{change-name}/specs/`
36
+ - relevant delta specs under `aspec/changes/{change-name}/specs/`
37
37
  - `tasks.md`
38
38
  - `design.md` when needed for implementation intent
39
39
 
40
- Treat the change's delta specs as the primary review target for active OpenSpec work. Read source-of-truth specs in `openspec/specs/` after the delta specs, and only when relevant to the affected capability.
40
+ Treat the change's delta specs as the primary review target for active aspec work. Read source-of-truth specs in `aspec/specs/` after the delta specs, and only when relevant to the affected capability.
41
41
 
42
42
  ### 2. Direct Implementation
43
43
 
@@ -47,7 +47,7 @@ If `@orchestrator` classified the task as `direct-implementation`, review agains
47
47
  - the user request
48
48
  - the implemented code and tests
49
49
 
50
- Do not assume an OpenSpec change exists for this mode.
50
+ Do not assume an aspec change exists for this mode.
51
51
 
52
52
  The delegation's Resolved Context Envelope and Validation Ledger are authoritative. Do not fetch Azure DevOps. If either is missing, report the missing evidence to `@orchestrator` instead of querying external systems.
53
53
 
@@ -60,11 +60,11 @@ If `@orchestrator` classified the task as `direct-test-only`, review against:
60
60
  - the existing implementation and tests
61
61
  - the tester's task-owned file union and Validation Ledger
62
62
 
63
- Do not assume an OpenSpec change exists for this mode. Do not raise `SPEC UPDATE RECOMMENDED` for test-only work.
63
+ Do not assume an aspec change exists for this mode. Do not raise `SPEC UPDATE RECOMMENDED` for test-only work.
64
64
 
65
65
  ## Required Workflow
66
66
 
67
- 1. Identify whether the task is `OpenSpec Change`, `direct-implementation`, or `direct-test-only`
67
+ 1. Identify whether the task is `aspec Change`, `direct-implementation`, or `direct-test-only`
68
68
  2. Read only the minimum relevant approved inputs and changed implementation files
69
69
  3. Review the task-owned files, related tests, and Validation Ledger produced for the approved scope
70
70
  4. Check for correctness issues, missing coverage, convention violations, and scope creep
@@ -73,7 +73,7 @@ Do not assume an OpenSpec change exists for this mode. Do not raise `SPEC UPDATE
73
73
 
74
74
  ## Scope Review Rules
75
75
 
76
- Review the changed files against the approved request or OpenSpec scope.
76
+ Review the changed files against the approved request or aspec scope.
77
77
 
78
78
  Review scope is limited to the `task-owned files` supplied by `@orchestrator` and their directly related files. Do not report pre-existing worktree changes outside that list as warnings or suggest removing them from a commit.
79
79
 
@@ -100,11 +100,11 @@ When reporting:
100
100
 
101
101
  ## Source-of-Truth Documentation Flag
102
102
 
103
- This applies only in `direct-implementation` mode. Direct changes skip the OpenSpec artifact flow, so a completed direct change can silently drift from the behavior documented in `openspec/specs/`.
103
+ This applies only in `direct-implementation` mode. Direct changes skip the aspec artifact flow, so a completed direct change can silently drift from the behavior documented in `aspec/specs/`.
104
104
 
105
105
  When reviewing a `direct-implementation` change:
106
106
 
107
- - Using the affected capability identified by `@orchestrator`, or inferred from the changed files, attempt to read the source-of-truth spec at `openspec/specs/{capability}/spec.md`
107
+ - Using the affected capability identified by `@orchestrator`, or inferred from the changed files, attempt to read the source-of-truth spec at `aspec/specs/{capability}/spec.md`
108
108
  - If that spec exists, compare the reviewed change against the behavior it documents
109
109
  - If the change altered behavior that the existing spec describes, raise a `SPEC UPDATE RECOMMENDED` flag naming the affected spec file
110
110
 
@@ -156,7 +156,7 @@ Example: `En lambda-render-handler, la version actual de Jest requiere --testPat
156
156
 
157
157
  Return a short structured report with:
158
158
 
159
- - review mode used: `OpenSpec Change`, `direct-implementation`, or `direct-test-only`
159
+ - review mode used: `aspec Change`, `direct-implementation`, or `direct-test-only`
160
160
  - `CRITICAL` issues
161
161
  - `WARNING` issues
162
162
  - `SUGGESTION` items
@@ -198,6 +198,6 @@ Use this format:
198
198
  ## Important
199
199
 
200
200
  - Review only the approved scope and its directly related files
201
- - Do not invent requirements that are not present in the approved request or OpenSpec artifacts
201
+ - Do not invent requirements that are not present in the approved request or aspec artifacts
202
202
  - Prefer actionable findings over broad commentary
203
203
  - If everything looks good, say so clearly
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Generates OpenSpec change artifacts for spec-driven development
2
+ description: Generates aspec change artifacts for spec-driven development
3
3
  mode: subagent
4
4
  model: opencode-go/qwen3.7-plus
5
5
  temperature: 0.2
@@ -11,32 +11,32 @@ tools:
11
11
  bash: false
12
12
  ---
13
13
 
14
- # OpenSpec Writer Agent
14
+ # aspec Writer Agent
15
15
 
16
- You are the technical architect's right hand for this project . Your mission is to produce clear, minimal, and actionable OpenSpec artifacts before implementation begins.
16
+ You are the technical architect's right hand for this project . Your mission is to produce clear, minimal, and actionable aspec artifacts before implementation begins.
17
17
 
18
18
  Read `AGENTS.md` at the repo root for project-specific conventions, tech stack, naming, and testing requirements.
19
19
 
20
20
  ## Language Requirement
21
21
 
22
22
  - All artifact content MUST be written in Spanish
23
- - File names and directory names MUST remain in English, following OpenSpec conventions
23
+ - File names and directory names MUST remain in English, following aspec conventions
24
24
 
25
25
  ## Primary Responsibility
26
26
 
27
- Generate an OpenSpec change in:
27
+ Generate an aspec change in:
28
28
 
29
- - `openspec/changes/{change-name}/`
29
+ - `aspec/changes/{change-name}/`
30
30
 
31
- using the `openspec-workflow` skill and the conventions of:
31
+ using the `ancleto-workflow` skill and the conventions of:
32
32
 
33
33
  - `AGENTS.md`
34
34
 
35
35
  ## Required Workflow
36
36
 
37
37
  1. Use the repository context received in the delegation, including its cited source paths and seed state; exploratory sweeping is prohibited. You MAY open a specific path that the received context cites when a detail needs confirmation.
38
- 2. Read relevant source-of-truth specs in `openspec/specs/` when they exist
39
- 3. Load and follow the `openspec-workflow` skill
38
+ 2. Read relevant source-of-truth specs in `aspec/specs/` when they exist
39
+ 3. Load and follow the `ancleto-workflow` skill
40
40
  4. Create a clear `change-name`
41
41
  5. Generate the minimum correct set of artifacts for the requested change:
42
42
  - `proposal.md`
@@ -83,7 +83,7 @@ Follow the project conventions from `AGENTS.md`, especially tech stack, naming c
83
83
 
84
84
  This is an existing codebase. Use the repository context received in the delegation instead of reconstructing the implementation through exploratory reading. Open a specific cited path only when required to confirm a detail.
85
85
 
86
- If a relevant OpenSpec source-of-truth spec already exists, write a delta against it instead of restating the full behavior.
86
+ If a relevant aspec source-of-truth spec already exists, write a delta against it instead of restating the full behavior.
87
87
 
88
88
  ## Output Expectations
89
89
 
@@ -97,7 +97,7 @@ After writing the artifacts, respond with a short structured summary including:
97
97
 
98
98
  ## Important
99
99
 
100
- - Prefer the smallest correct OpenSpec change that captures the intended behavior
100
+ - Prefer the smallest correct aspec change that captures the intended behavior
101
101
  - If the request is too ambiguous to spec safely, report the ambiguity clearly
102
102
  - If no existing spec matches the capability, create a new capability delta under the change
103
103
  - Keep the artifacts useful for both human review and downstream implementation agents
@@ -38,14 +38,14 @@ Pick the source by the **class of question**, not by habit. Always state which s
38
38
  | Class of question | Source |
39
39
  | ----------------------------------------------------------------------- | ------------------------------------------------ |
40
40
  | how is this built, where does this rule live, what breaks if I change X | `docs/technical-discovery/` (the technical seed) |
41
- | what behavior is agreed today | `openspec/specs/` |
42
- | why is it done this way, what was discarded and why | `openspec/changes/archive/` |
43
- | is there anything in flight that touches this | unarchived changes in `openspec/changes/` |
41
+ | what behavior is agreed today | `aspec/specs/` |
42
+ | why is it done this way, what was discarded and why | `aspec/changes/archive/` |
43
+ | is there anything in flight that touches this | unarchived changes in `aspec/changes/` |
44
44
  | conventions, stack, commands | `AGENTS.md`, `PRODUCT.md` |
45
45
 
46
46
  Notes on routing:
47
47
 
48
- - Questions of **intent** ("why is it like this") route to `openspec/changes/archive/` **before** the seed. The seed is derived from code, so it holds structure and behavior but not intent.
48
+ - Questions of **intent** ("why is it like this") route to `aspec/changes/archive/` **before** the seed. The seed is derived from code, so it holds structure and behavior but not intent.
49
49
  - A question may need one source, not all five. Do not tour the sources.
50
50
  - When you read unarchived changes, you report **what is in flight that could collide**. You do NOT decide whether to resume, archive, or discard any change — that is the `@orchestrator`'s Active Change Check.
51
51
  - Select one source before using any tool. When that source is a known specification, decision record, or repository convention document, read it directly and do not inspect technical-seed state.
@@ -112,7 +112,7 @@ Search is bounded like everything else here: a targeted query for the question a
112
112
 
113
113
  ## You never act
114
114
 
115
- Any request to create, modify, or implement — including writing OpenSpec artifacts or generating the seed — is out of scope. Return the context you have and hand the request off, without attempting the action even partially.
115
+ Any request to create, modify, or implement — including writing aspec artifacts or generating the seed — is out of scope. Return the context you have and hand the request off, without attempting the action even partially.
116
116
 
117
117
  | Situation | Action |
118
118
  | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
@@ -30,7 +30,7 @@ Read `AGENTS.md` at the repo root for project conventions and guardrails .
30
30
  content, language, command sequence, exclusions, and output validation.
31
31
  - Write only beneath `config.outputDir` from the `ancleto discovery --check` report passed by
32
32
  `@orchestrator` (normally `docs/technical-discovery/`). Do not modify application code,
33
- OpenSpec artifacts, configuration, or files outside that directory.
33
+ aspec artifacts, configuration, or files outside that directory.
34
34
  - Never create an empty directory or empty document.
35
35
  - Do not create commits, stage files, install dependencies, call network services, or invoke
36
36
  subagents.
package/agents/tester.md CHANGED
@@ -25,7 +25,7 @@ Read `AGENTS.md` at the repo root for project-specific testing conventions, fram
25
25
 
26
26
  Validate changes using one of these approved inputs:
27
27
 
28
- - An active OpenSpec change in `openspec/changes/{change-name}/`
28
+ - An active aspec change in `aspec/changes/{change-name}/`
29
29
  - A direct implementation request explicitly approved by `@orchestrator`
30
30
  - A direct test-only request explicitly approved by `@orchestrator`
31
31
 
@@ -71,15 +71,15 @@ When reporting results:
71
71
 
72
72
  ## Input Modes
73
73
 
74
- ### 1. OpenSpec Change
74
+ ### 1. aspec Change
75
75
 
76
- If an approved OpenSpec change exists, validate against:
76
+ If an approved aspec change exists, validate against:
77
77
 
78
- - relevant delta specs under `openspec/changes/{change-name}/specs/`
78
+ - relevant delta specs under `aspec/changes/{change-name}/specs/`
79
79
  - `tasks.md`
80
80
  - `design.md` when needed for mocks or technical assumptions
81
81
 
82
- Treat the change's delta specs as the primary verification target for active OpenSpec work. Read source-of-truth specs in `openspec/specs/` after the delta specs, and only when relevant to the affected capability.
82
+ Treat the change's delta specs as the primary verification target for active aspec work. Read source-of-truth specs in `aspec/specs/` after the delta specs, and only when relevant to the affected capability.
83
83
 
84
84
  ### 2. Direct Implementation
85
85
 
@@ -89,7 +89,7 @@ If `@orchestrator` classified the task as `direct-implementation`, validate agai
89
89
  - the user request
90
90
  - the implemented code
91
91
 
92
- Do not assume an OpenSpec change exists for this mode.
92
+ Do not assume an aspec change exists for this mode.
93
93
 
94
94
  ### 3. Direct Test-Only
95
95
 
@@ -105,7 +105,7 @@ If you discover that the request actually requires product-code changes, a behav
105
105
 
106
106
  ## Required Workflow
107
107
 
108
- 1. Identify whether the task is `OpenSpec Change`, `direct-implementation`, or `direct-test-only`
108
+ 1. Identify whether the task is `aspec Change`, `direct-implementation`, or `direct-test-only`
109
109
  2. Read only the minimum relevant artifacts, instructions, and implementation files
110
110
  3. Review the code produced by `@coder`, or the existing implementation directly for `direct-test-only`
111
111
  4. Add or update unit tests where they meaningfully validate the approved behavior
@@ -157,7 +157,7 @@ Use the project's established test structure and patterns from nearby tests befo
157
157
 
158
158
  After validation, return a short structured summary including:
159
159
 
160
- - input mode used: `OpenSpec Change`, `direct-implementation`, or `direct-test-only`
160
+ - input mode used: `aspec Change`, `direct-implementation`, or `direct-test-only`
161
161
  - tests created or updated
162
162
  - `task-owned test files`: the exact tests modified during this delegation
163
163
  - `final task-owned files`: the coder's task-owned files plus tests modified during this delegation
@@ -171,7 +171,7 @@ After validation, return a short structured summary including:
171
171
 
172
172
  - Prefer the smallest useful test change that validates the approved behavior
173
173
  - Keep tests aligned with existing repo patterns
174
- - Do not invent requirements that are not present in the approved request or OpenSpec artifacts
174
+ - Do not invent requirements that are not present in the approved request or aspec artifacts
175
175
  - Focus on correctness, regression prevention, and maintainability
176
176
 
177
177
  If you decide that no unit-test change is required for a `spec-required` change, state that explicitly and justify why the existing coverage is sufficient.
@@ -1,10 +1,10 @@
1
1
  ---
2
- description: Implement tasks from an OpenSpec change (Experimental)
2
+ description: Implement tasks from an aspec change (Experimental)
3
3
  ---
4
4
 
5
- Implement tasks from an OpenSpec change.
5
+ Implement tasks from an aspec change.
6
6
 
7
- **Input**: Optionally specify a change name (e.g., `/opsx-apply add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
7
+ **Input**: Optionally specify a change name (e.g., `/cleto-apply add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
8
8
 
9
9
  **Steps**
10
10
 
@@ -14,14 +14,14 @@ Implement tasks from an OpenSpec change.
14
14
 
15
15
  - Infer from conversation context if the user mentioned a change
16
16
  - Auto-select if only one active change exists
17
- - If ambiguous, run `openspec list --json` to get available changes and use the **AskUserQuestion tool** to let the user select
17
+ - If ambiguous, run `aspec list --json` to get available changes and use the **AskUserQuestion tool** to let the user select
18
18
 
19
- Always announce: "Using change: <name>" and how to override (e.g., `/opsx-apply <other>`).
19
+ Always announce: "Using change: <name>" and how to override (e.g., `/cleto-apply <other>`).
20
20
 
21
21
  2. **Check status to understand the schema**
22
22
 
23
23
  ```bash
24
- openspec status --change "<name>" --json
24
+ aspec status --change "<name>" --json
25
25
  ```
26
26
 
27
27
  Parse the JSON to understand:
@@ -32,7 +32,7 @@ Implement tasks from an OpenSpec change.
32
32
  3. **Get apply instructions**
33
33
 
34
34
  ```bash
35
- openspec instructions apply --change "<name>" --json
35
+ aspec instructions apply --change "<name>" --json
36
36
  ```
37
37
 
38
38
  This returns:
@@ -44,7 +44,7 @@ Implement tasks from an OpenSpec change.
44
44
 
45
45
  **Handle states:**
46
46
 
47
- - If `state: "blocked"` (missing artifacts): show message, suggest using `/opsx-continue`
47
+ - If `state: "blocked"` (missing artifacts): show message, suggest using `/cleto-continue`
48
48
  - If `state: "all_done"`: congratulate, suggest archive
49
49
  - Otherwise: proceed to implementation
50
50
 
@@ -119,7 +119,7 @@ Working on task 4/7: <task description>
119
119
  - [x] Task 2
120
120
  ...
121
121
 
122
- All tasks complete! You can archive this change with `/opsx-archive`.
122
+ All tasks complete! You can archive this change with `/cleto-archive`.
123
123
  ```
124
124
 
125
125
  **Output On Pause (Issue Encountered)**
@@ -4,13 +4,13 @@ description: Archive a completed change in the experimental workflow
4
4
 
5
5
  Archive a completed change in the experimental workflow.
6
6
 
7
- **Input**: Optionally specify a change name after `/opsx-archive` (e.g., `/opsx-archive add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
7
+ **Input**: Optionally specify a change name after `/cleto-archive` (e.g., `/cleto-archive add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
8
8
 
9
9
  **Steps**
10
10
 
11
11
  1. **If no change name provided, prompt for selection**
12
12
 
13
- Run `openspec list --json` to get available changes. Use the **AskUserQuestion tool** to let the user select.
13
+ Run `aspec list --json` to get available changes. Use the **AskUserQuestion tool** to let the user select.
14
14
 
15
15
  Show only active changes (not already archived).
16
16
  Include the schema used for each change if available.
@@ -19,7 +19,7 @@ Archive a completed change in the experimental workflow.
19
19
 
20
20
  2. **Check artifact completion status**
21
21
 
22
- Run `openspec status --change "<name>" --json` to check artifact completion.
22
+ Run `aspec status --change "<name>" --json` to check artifact completion.
23
23
 
24
24
  Parse the JSON to understand:
25
25
 
@@ -48,11 +48,11 @@ Archive a completed change in the experimental workflow.
48
48
 
49
49
  4. **Assess delta spec sync state**
50
50
 
51
- Check for delta specs at `openspec/changes/<name>/specs/`. If none exist, proceed without sync prompt.
51
+ Check for delta specs at `aspec/changes/<name>/specs/`. If none exist, proceed without sync prompt.
52
52
 
53
53
  **If delta specs exist:**
54
54
 
55
- - Compare each delta spec with its corresponding main spec at `openspec/specs/<capability>/spec.md`
55
+ - Compare each delta spec with its corresponding main spec at `aspec/specs/<capability>/spec.md`
56
56
  - Determine what changes would be applied (adds, modifications, removals, renames)
57
57
  - Show a combined summary before prompting
58
58
 
@@ -61,14 +61,14 @@ Archive a completed change in the experimental workflow.
61
61
  - If changes needed: "Sync now (recommended)", "Archive without syncing"
62
62
  - If already synced: "Archive now", "Sync anyway", "Cancel"
63
63
 
64
- If user chooses sync, use Task tool (subagent_type: "general-purpose", prompt: "Use Skill tool to invoke openspec-sync-specs for change '<name>'. Delta spec analysis: <include the analyzed delta spec summary>"). Proceed to archive regardless of choice.
64
+ If user chooses sync, use Task tool (subagent_type: "general-purpose", prompt: "Use Skill tool to invoke ancleto-sync-specs for change '<name>'. Delta spec analysis: <include the analyzed delta spec summary>"). Proceed to archive regardless of choice.
65
65
 
66
66
  5. **Perform the archive**
67
67
 
68
68
  Create the archive directory if it doesn't exist:
69
69
 
70
70
  ```bash
71
- mkdir -p openspec/changes/archive
71
+ mkdir -p aspec/changes/archive
72
72
  ```
73
73
 
74
74
  Generate target name using current date: `YYYY-MM-DD-<change-name>`
@@ -81,13 +81,13 @@ Archive a completed change in the experimental workflow.
81
81
  **Before moving**, delete scaffold-only files if present — they must not be preserved in the archive:
82
82
 
83
83
  ```bash
84
- rm -f openspec/changes/<name>/context.md
84
+ rm -f aspec/changes/<name>/context.md
85
85
  ```
86
86
 
87
87
  Then move:
88
88
 
89
89
  ```bash
90
- mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>
90
+ mv aspec/changes/<name> aspec/changes/archive/YYYY-MM-DD-<name>
91
91
  ```
92
92
 
93
93
  6. **Display summary**
@@ -107,7 +107,7 @@ Archive a completed change in the experimental workflow.
107
107
 
108
108
  **Change:** <change-name>
109
109
  **Schema:** <schema-name>
110
- **Archived to:** openspec/changes/archive/YYYY-MM-DD-<name>/
110
+ **Archived to:** aspec/changes/archive/YYYY-MM-DD-<name>/
111
111
  **Specs:** ✓ Synced to main specs
112
112
 
113
113
  All artifacts complete. All tasks complete.
@@ -120,7 +120,7 @@ All artifacts complete. All tasks complete.
120
120
 
121
121
  **Change:** <change-name>
122
122
  **Schema:** <schema-name>
123
- **Archived to:** openspec/changes/archive/YYYY-MM-DD-<name>/
123
+ **Archived to:** aspec/changes/archive/YYYY-MM-DD-<name>/
124
124
  **Specs:** No delta specs
125
125
 
126
126
  All artifacts complete. All tasks complete.
@@ -133,7 +133,7 @@ All artifacts complete. All tasks complete.
133
133
 
134
134
  **Change:** <change-name>
135
135
  **Schema:** <schema-name>
136
- **Archived to:** openspec/changes/archive/YYYY-MM-DD-<name>/
136
+ **Archived to:** aspec/changes/archive/YYYY-MM-DD-<name>/
137
137
  **Specs:** Sync skipped (user chose to skip)
138
138
 
139
139
  **Warnings:**
@@ -150,7 +150,7 @@ Review the archive if this was not intentional.
150
150
  ## Archive Failed
151
151
 
152
152
  **Change:** <change-name>
153
- **Target:** openspec/changes/archive/YYYY-MM-DD-<name>/
153
+ **Target:** aspec/changes/archive/YYYY-MM-DD-<name>/
154
154
 
155
155
  Target archive directory already exists.
156
156
 
@@ -163,9 +163,9 @@ Target archive directory already exists.
163
163
  **Guardrails**
164
164
 
165
165
  - Always prompt for change selection if not provided
166
- - Use artifact graph (openspec status --json) for completion checking
166
+ - Use artifact graph (aspec status --json) for completion checking
167
167
  - Don't block archive on warnings - just inform and confirm
168
- - Preserve .openspec.yaml when moving to archive (it moves with the directory)
168
+ - Preserve .aspec.yaml when moving to archive (it moves with the directory)
169
169
  - Show clear summary of what happened
170
- - If sync is requested, use the Skill tool to invoke `openspec-sync-specs` (agent-driven)
170
+ - If sync is requested, use the Skill tool to invoke `ancleto-sync-specs` (agent-driven)
171
171
  - If delta specs exist, always run the sync assessment and show the combined summary before prompting
@@ -12,7 +12,7 @@ This skill allows you to batch-archive changes, handling spec conflicts intellig
12
12
 
13
13
  1. **Get active changes**
14
14
 
15
- Run `openspec list --json` to get all active changes.
15
+ Run `aspec list --json` to get all active changes.
16
16
 
17
17
  If no active changes exist, inform user and stop.
18
18
 
@@ -30,17 +30,17 @@ This skill allows you to batch-archive changes, handling spec conflicts intellig
30
30
 
31
31
  For each selected change, collect:
32
32
 
33
- a. **Artifact status** - Run `openspec status --change "<name>" --json`
33
+ a. **Artifact status** - Run `aspec status --change "<name>" --json`
34
34
 
35
35
  - Parse `schemaName` and `artifacts` list
36
36
  - Note which artifacts are `done` vs other states
37
37
 
38
- b. **Task completion** - Read `openspec/changes/<name>/tasks.md`
38
+ b. **Task completion** - Read `aspec/changes/<name>/tasks.md`
39
39
 
40
40
  - Count `- [ ]` (incomplete) vs `- [x]` (complete)
41
41
  - If no tasks file exists, note as "No tasks"
42
42
 
43
- c. **Delta specs** - Check `openspec/changes/<name>/specs/` directory
43
+ c. **Delta specs** - Check `aspec/changes/<name>/specs/` directory
44
44
 
45
45
  - List which capability specs exist
46
46
  - For each, extract requirement names (lines matching `### Requirement: <name>`)
@@ -124,15 +124,15 @@ This skill allows you to batch-archive changes, handling spec conflicts intellig
124
124
 
125
125
  a. **Sync specs** if delta specs exist:
126
126
 
127
- - Use the openspec-sync-specs approach (agent-driven intelligent merge)
127
+ - Use the ancleto-sync-specs approach (agent-driven intelligent merge)
128
128
  - For conflicts, apply in resolved order
129
129
  - Track if sync was done
130
130
 
131
131
  b. **Perform the archive**:
132
132
 
133
133
  ```bash
134
- mkdir -p openspec/changes/archive
135
- mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>
134
+ mkdir -p aspec/changes/archive
135
+ mv aspec/changes/<name> aspec/changes/archive/YYYY-MM-DD-<name>
136
136
  ```
137
137
 
138
138
  c. **Track outcome** for each change:
@@ -250,6 +250,6 @@ No active changes found. Create a new change to get started.
250
250
  - Show clear per-change status before confirming
251
251
  - Use single confirmation for entire batch
252
252
  - Track and report all outcomes (success/skip/fail)
253
- - Preserve .openspec.yaml when moving to archive
253
+ - Preserve .aspec.yaml when moving to archive
254
254
  - Archive directory target uses current date: YYYY-MM-DD-<name>
255
255
  - If archive target exists, fail that change but continue with others
@@ -4,13 +4,13 @@ description: Continue working on a change - create the next artifact (Experiment
4
4
 
5
5
  Continue working on a change by creating the next artifact.
6
6
 
7
- **Input**: Optionally specify a change name after `/opsx-continue` (e.g., `/opsx-continue add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
7
+ **Input**: Optionally specify a change name after `/cleto-continue` (e.g., `/cleto-continue add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
8
8
 
9
9
  **Steps**
10
10
 
11
11
  1. **If no change name provided, prompt for selection**
12
12
 
13
- Run `openspec list --json` to get available changes sorted by most recently modified. Then use the **AskUserQuestion tool** to let the user select which change to work on.
13
+ Run `aspec list --json` to get available changes sorted by most recently modified. Then use the **AskUserQuestion tool** to let the user select which change to work on.
14
14
 
15
15
  Present the top 3-4 most recently modified changes as options, showing:
16
16
 
@@ -26,7 +26,7 @@ Continue working on a change by creating the next artifact.
26
26
  2. **Check current status**
27
27
 
28
28
  ```bash
29
- openspec status --change "<name>" --json
29
+ aspec status --change "<name>" --json
30
30
  ```
31
31
 
32
32
  Parse the JSON to understand current state. The response includes:
@@ -41,7 +41,7 @@ Continue working on a change by creating the next artifact.
41
41
 
42
42
  Otherwise, read it as background context — it is NOT an artifact and must NOT be included in output files, but its contents inform what you write:
43
43
 
44
- - `openspec/changes/<name>/context.md` — Work Item context (title, description, acceptance criteria)
44
+ - `aspec/changes/<name>/context.md` — Work Item context (title, description, acceptance criteria)
45
45
 
46
46
  If either file is missing, skip silently.
47
47
 
@@ -53,7 +53,7 @@ Continue working on a change by creating the next artifact.
53
53
 
54
54
  - Congratulate the user
55
55
  - Show final status including the schema used
56
- - Suggest: "All artifacts created! You can now implement this change with `/opsx-apply` or archive it with `/opsx-archive`."
56
+ - Suggest: "All artifacts created! You can now implement this change with `/cleto-apply` or archive it with `/cleto-archive`."
57
57
  - STOP
58
58
 
59
59
  ***
@@ -63,7 +63,7 @@ Continue working on a change by creating the next artifact.
63
63
  - Pick the FIRST artifact with `status: "ready"` from the status output
64
64
  - Get its instructions:
65
65
  ```bash
66
- openspec instructions <artifact-id> --change "<name>" --json
66
+ aspec instructions <artifact-id> --change "<name>" --json
67
67
  ```
68
68
  - Parse the JSON. The key fields are:
69
69
  - `context`: Project background (constraints for you - do NOT include in output)
@@ -91,7 +91,7 @@ Continue working on a change by creating the next artifact.
91
91
 
92
92
  5. **After creating an artifact, show progress**
93
93
  ```bash
94
- openspec status --change "<name>"
94
+ aspec status --change "<name>"
95
95
  ```
96
96
 
97
97
  **Output**
@@ -102,7 +102,7 @@ After each invocation, show:
102
102
  - Schema workflow being used
103
103
  - Current progress (N/M complete)
104
104
  - What artifacts are now unlocked
105
- - Prompt: "Run `/opsx-continue` to create the next artifact"
105
+ - Prompt: "Run `/cleto-continue` to create the next artifact"
106
106
 
107
107
  **Artifact Creation Guidelines**
108
108
 
@@ -4,11 +4,11 @@ description: Enter explore mode - think through ideas, investigate problems, cla
4
4
 
5
5
  Enter explore mode. Think deeply. Visualize freely. Follow the conversation wherever it goes.
6
6
 
7
- **IMPORTANT: Explore mode is for thinking, not implementing.** You may read files, search code, and investigate the codebase, but you must NEVER write code or implement features. If the user asks you to implement something, remind them to exit explore mode first and create a change proposal. You MAY create OpenSpec artifacts (proposals, designs, specs) if the user asks—that's capturing thinking, not implementing.
7
+ **IMPORTANT: Explore mode is for thinking, not implementing.** You may read files, search code, and investigate the codebase, but you must NEVER write code or implement features. If the user asks you to implement something, remind them to exit explore mode first and create a change proposal. You MAY create aspec artifacts (proposals, designs, specs) if the user asks—that's capturing thinking, not implementing.
8
8
 
9
9
  **This is a stance, not a workflow.** There are no fixed steps, no required sequence, no mandatory outputs. You're a thinking partner helping the user explore.
10
10
 
11
- **Input**: The argument after `/opsx-explore` is whatever the user wants to think about. Could be:
11
+ **Input**: The argument after `/cleto-explore` is whatever the user wants to think about. Could be:
12
12
 
13
13
  - A vague idea: "real-time collaboration"
14
14
  - A specific problem: "the auth system is getting unwieldy"
@@ -81,16 +81,16 @@ Depending on what the user brings, you might:
81
81
 
82
82
  ---
83
83
 
84
- ## OpenSpec Awareness
84
+ ## aspec Awareness
85
85
 
86
- You have full context of the OpenSpec system. Use it naturally, don't force it.
86
+ You have full context of the aspec system. Use it naturally, don't force it.
87
87
 
88
88
  ### Check for context
89
89
 
90
90
  At the start, quickly check what exists:
91
91
 
92
92
  ```bash
93
- openspec list --json
93
+ aspec list --json
94
94
  ```
95
95
 
96
96
  This tells you:
@@ -114,9 +114,9 @@ If the user mentions a change or you detect one is relevant:
114
114
 
115
115
  1. **Read existing artifacts for context**
116
116
 
117
- - `openspec/changes/<name>/proposal.md`
118
- - `openspec/changes/<name>/design.md`
119
- - `openspec/changes/<name>/tasks.md`
117
+ - `aspec/changes/<name>/proposal.md`
118
+ - `aspec/changes/<name>/design.md`
119
+ - `aspec/changes/<name>/tasks.md`
120
120
  - etc.
121
121
 
122
122
  2. **Reference them naturally in conversation**
@@ -171,7 +171,7 @@ When things crystallize, you might offer a summary - but it's optional. Sometime
171
171
 
172
172
  ## Guardrails
173
173
 
174
- - **Don't implement** - Never write code or implement features. Creating OpenSpec artifacts is fine, writing application code is not.
174
+ - **Don't implement** - Never write code or implement features. Creating aspec artifacts is fine, writing application code is not.
175
175
  - **Don't fake understanding** - If something is unclear, dig deeper
176
176
  - **Don't rush** - Discovery is thinking time, not task time
177
177
  - **Don't force structure** - Let patterns emerge naturally