@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
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: openspec-apply
2
+ name: ancleto-apply
3
3
  description: Implement tasks from a change step by step, tracking progress in tasks.md. Use when artifacts are ready and implementation should start. No external binaries required.
4
4
  license: MIT
5
5
  compatibility: No external binaries required. Works with any agent runtime.
@@ -8,24 +8,24 @@ metadata:
8
8
  version: '1.0'
9
9
  ---
10
10
 
11
- # OpenSpec Apply
11
+ # aspec Apply
12
12
 
13
13
  Implement the tasks of a change, working directly from its artifact files. No external binaries are invoked: task state lives in `tasks.md` checkboxes.
14
14
 
15
- **Input**: Optionally specify a change name (e.g., `add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous, list the directories under `openspec/changes/` and ask the user to select.
15
+ **Input**: Optionally specify a change name (e.g., `add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous, list the directories under `aspec/changes/` and ask the user to select.
16
16
 
17
17
  ## Steps
18
18
 
19
19
  ### 1. Select the change
20
20
 
21
21
  - If a name is provided, use it. Announce: "Using change: `<name>`" and how to override.
22
- - If omitted: infer from conversation context; auto-select if only one active change directory exists under `openspec/changes/`; otherwise list the directories and ask the user to choose.
22
+ - If omitted: infer from conversation context; auto-select if only one active change directory exists under `aspec/changes/`; otherwise list the directories and ask the user to choose.
23
23
 
24
24
  **IMPORTANT**: Do NOT guess or auto-select when ambiguous. Always let the user choose.
25
25
 
26
26
  ### 2. Understand the change state
27
27
 
28
- Read the change directory `openspec/changes/<name>/` and load:
28
+ Read the change directory `aspec/changes/<name>/` and load:
29
29
 
30
30
  - `proposal.md` — what & why (if present)
31
31
  - `design.md` — approach and decisions (if present)
@@ -78,7 +78,7 @@ For each pending task (`- [ ]`):
78
78
  **Change:** <change-name>
79
79
  **Progress:** N/N tasks complete ✓
80
80
 
81
- All tasks complete! You can archive this change with `openspec-archive`.
81
+ All tasks complete! You can archive this change with `ancleto-archive`.
82
82
  ```
83
83
 
84
84
  **On pause:**
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: openspec-archive
2
+ name: ancleto-archive
3
3
  description: Archive a completed change, syncing delta specs first when needed. Use when implementation and verification are done. Captures lessons into persistent memory. No external binaries required.
4
4
  license: MIT
5
5
  compatibility: No external binaries required. Works with any agent runtime.
@@ -8,11 +8,11 @@ metadata:
8
8
  version: '1.0'
9
9
  ---
10
10
 
11
- # OpenSpec Archive
11
+ # aspec Archive
12
12
 
13
13
  Archive a completed change by moving its directory, after checking completion and syncing delta specs. No external binaries are invoked: completion is read from files, archiving is a directory move.
14
14
 
15
- **Input**: Optionally specify a change name (e.g., `add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous, list the directories under `openspec/changes/` (excluding `archive/`) and ask the user to select.
15
+ **Input**: Optionally specify a change name (e.g., `add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous, list the directories under `aspec/changes/` (excluding `archive/`) and ask the user to select.
16
16
 
17
17
  **IMPORTANT**: Do NOT guess or auto-select a change. Always let the user choose.
18
18
 
@@ -20,21 +20,21 @@ Archive a completed change by moving its directory, after checking completion an
20
20
 
21
21
  ### 1. Check task completion status
22
22
 
23
- Read `openspec/changes/<name>/tasks.md` (when it exists) and count tasks marked with `- [ ]` (incomplete) vs `- [x]` (complete).
23
+ Read `aspec/changes/<name>/tasks.md` (when it exists) and count tasks marked with `- [ ]` (incomplete) vs `- [x]` (complete).
24
24
 
25
25
  - **If incomplete tasks found**: display a warning showing the count, prompt the user for confirmation to continue, and proceed only if confirmed.
26
26
  - **If no tasks file exists**: proceed without a task-related warning.
27
27
 
28
28
  ### 2. Assess delta spec sync state
29
29
 
30
- Check for delta specs at `openspec/changes/<name>/specs/`. If none exist, proceed without a sync prompt.
30
+ Check for delta specs at `aspec/changes/<name>/specs/`. If none exist, proceed without a sync prompt.
31
31
 
32
32
  **If delta specs exist:**
33
33
 
34
- - Compare each delta spec with its corresponding main spec at `openspec/specs/<capability>/spec.md`.
34
+ - Compare each delta spec with its corresponding main spec at `aspec/specs/<capability>/spec.md`.
35
35
  - Determine what would change (adds, modifications, removals, renames) and show a combined summary.
36
36
  - Prompt the user: "Sync now (recommended)" vs "Archive without syncing" (or "Archive now" / "Sync anyway" / "Cancel" when already synced).
37
- - If the user chooses sync, apply the delta to the main spec directly, editing `openspec/specs/<capability>/spec.md`:
37
+ - If the user chooses sync, apply the delta to the main spec directly, editing `aspec/specs/<capability>/spec.md`:
38
38
  - `## ADDED Requirements` → add the new requirement blocks (skip those already present).
39
39
  - `## MODIFIED Requirements` → update the matching requirement, preserving scenarios not mentioned in the delta.
40
40
  - `## REMOVED Requirements` → remove the entire requirement block.
@@ -43,12 +43,12 @@ Check for delta specs at `openspec/changes/<name>/specs/`. If none exist, procee
43
43
 
44
44
  ### 3. Perform the archive
45
45
 
46
- Create the archive directory if it does not exist: `openspec/changes/archive/`.
46
+ Create the archive directory if it does not exist: `aspec/changes/archive/`.
47
47
 
48
48
  Generate the target name using the current date: `YYYY-MM-DD-<change-name>`.
49
49
 
50
50
  - **If the target already exists**: fail with an error suggesting to rename the existing archive or pick a different date.
51
- - **If not**: delete scaffold-only files (e.g., `openspec/changes/<name>/context.md` — they must not be preserved), then move the whole change directory to `openspec/changes/archive/YYYY-MM-DD-<name>/`.
51
+ - **If not**: delete scaffold-only files (e.g., `aspec/changes/<name>/context.md` — they must not be preserved), then move the whole change directory to `aspec/changes/archive/YYYY-MM-DD-<name>/`.
52
52
 
53
53
  ### 4. Capture lessons into persistent memory
54
54
 
@@ -71,7 +71,7 @@ Record only durable lessons — decisions whose reasons are not visible in the r
71
71
  ## Archive Complete
72
72
 
73
73
  **Change:** <change-name>
74
- **Archived to:** openspec/changes/archive/YYYY-MM-DD-<name>/
74
+ **Archived to:** aspec/changes/archive/YYYY-MM-DD-<name>/
75
75
  **Specs:** ✓ Synced to main specs (or: No delta specs / Sync skipped)
76
76
 
77
77
  **Memories recorded:** <list, or "None">
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: openspec-bulk-archive
2
+ name: ancleto-bulk-archive
3
3
  description: Archive multiple completed changes in one batch, resolving spec conflicts by checking the codebase. Use when several changes are done and should be archived together. No external binaries required.
4
4
  license: MIT
5
5
  compatibility: No external binaries required. Works with any agent runtime.
@@ -8,7 +8,7 @@ metadata:
8
8
  version: '1.0'
9
9
  ---
10
10
 
11
- # OpenSpec Bulk Archive
11
+ # aspec Bulk Archive
12
12
 
13
13
  Archive multiple completed changes in a single operation, handling spec conflicts by checking what is actually implemented. No external binaries are invoked: changes are listed from directories, status is read from files, archiving is a directory move.
14
14
 
@@ -18,7 +18,7 @@ Archive multiple completed changes in a single operation, handling spec conflict
18
18
 
19
19
  ### 1. Get active changes
20
20
 
21
- List the directories directly under `openspec/changes/` (excluding `archive/`). If none exist, inform the user and stop.
21
+ List the directories directly under `aspec/changes/` (excluding `archive/`). If none exist, inform the user and stop.
22
22
 
23
23
  ### 2. Prompt for change selection
24
24
 
@@ -34,11 +34,11 @@ Use the **AskUserQuestion tool** with multi-select to let the user choose:
34
34
 
35
35
  For each selected change, collect by reading files:
36
36
 
37
- a. **Artifact presence** — which of `proposal.md`, `design.md`, `tasks.md`, `specs/` exist under `openspec/changes/<name>/`.
37
+ a. **Artifact presence** — which of `proposal.md`, `design.md`, `tasks.md`, `specs/` exist under `aspec/changes/<name>/`.
38
38
 
39
- b. **Task completion** — read `openspec/changes/<name>/tasks.md` and count `- [ ]` (incomplete) vs `- [x]` (complete). If no tasks file exists, note "No tasks".
39
+ b. **Task completion** — read `aspec/changes/<name>/tasks.md` and count `- [ ]` (incomplete) vs `- [x]` (complete). If no tasks file exists, note "No tasks".
40
40
 
41
- c. **Delta specs** — check `openspec/changes/<name>/specs/` and list which capability specs exist, extracting requirement names (lines matching `### Requirement: <name>`).
41
+ c. **Delta specs** — check `aspec/changes/<name>/specs/` and list which capability specs exist, extracting requirement names (lines matching `### Requirement: <name>`).
42
42
 
43
43
  ### 4. Detect spec conflicts
44
44
 
@@ -89,9 +89,9 @@ If there are incomplete changes, make clear they will be archived with warnings.
89
89
 
90
90
  Process changes in the determined order (respecting conflict resolution):
91
91
 
92
- a. **Sync specs** if delta specs exist and the resolution says so: apply the delta directly to `openspec/specs/<capability>/spec.md` (ADDED adds, MODIFIED updates preserving unmentioned scenarios, REMOVED deletes, RENAMED renames via `FROM:`/`TO:`). Track whether sync was done.
92
+ a. **Sync specs** if delta specs exist and the resolution says so: apply the delta directly to `aspec/specs/<capability>/spec.md` (ADDED adds, MODIFIED updates preserving unmentioned scenarios, REMOVED deletes, RENAMED renames via `FROM:`/`TO:`). Track whether sync was done.
93
93
 
94
- b. **Perform the archive**: create `openspec/changes/archive/` if missing, delete scaffold-only files (`context.md`), then move the directory to `openspec/changes/archive/YYYY-MM-DD-<name>/`. If the target already exists, fail that change (record the error) but continue with the others.
94
+ b. **Perform the archive**: create `aspec/changes/archive/` if missing, delete scaffold-only files (`context.md`), then move the directory to `aspec/changes/archive/YYYY-MM-DD-<name>/`. If the target already exists, fail that change (record the error) but continue with the others.
95
95
 
96
96
  c. **Track each outcome**: success, failed (with error), or skipped.
97
97
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: openspec-continue
2
+ name: ancleto-continue
3
3
  description: Continue working on an existing change by creating its next missing artifact. Use to resume artifact creation one step at a time. No external binaries required.
4
4
  license: MIT
5
5
  compatibility: No external binaries required. Works with any agent runtime.
@@ -8,11 +8,11 @@ metadata:
8
8
  version: '1.0'
9
9
  ---
10
10
 
11
- # OpenSpec Continue
11
+ # aspec Continue
12
12
 
13
13
  Continue working on a change by creating exactly ONE next artifact. No external binaries are invoked: change state is derived by reading which artifact files exist.
14
14
 
15
- **Input**: Optionally specify a change name (e.g., `add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous, list the directories under `openspec/changes/` (excluding `archive/`) and ask the user to select, marking the most recently modified one as "(Recommended)".
15
+ **Input**: Optionally specify a change name (e.g., `add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous, list the directories under `aspec/changes/` (excluding `archive/`) and ask the user to select, marking the most recently modified one as "(Recommended)".
16
16
 
17
17
  **IMPORTANT**: Do NOT guess or auto-select a change. Always let the user choose.
18
18
 
@@ -20,7 +20,7 @@ Continue working on a change by creating exactly ONE next artifact. No external
20
20
 
21
21
  ### 1. Determine the next missing artifact
22
22
 
23
- Read `openspec/changes/<name>/` and check for artifact files in this fixed dependency order:
23
+ Read `aspec/changes/<name>/` and check for artifact files in this fixed dependency order:
24
24
 
25
25
  1. `proposal.md` — what & why
26
26
  2. `specs/` — delta requirements (at least one `spec.md` inside; skip only if the change specifies no behavior)
@@ -29,7 +29,7 @@ Read `openspec/changes/<name>/` and check for artifact files in this fixed depen
29
29
 
30
30
  The first item in this order that is absent (or, for `specs/`, contains no `spec.md`) is the next artifact to create.
31
31
 
32
- - **If all four are present**: congratulate the user, show the status, and suggest "All artifacts created! You can now implement this change with `openspec-apply` or archive it with `openspec-archive`." STOP.
32
+ - **If all four are present**: congratulate the user, show the status, and suggest "All artifacts created! You can now implement this change with `ancleto-apply` or archive it with `ancleto-archive`." STOP.
33
33
  - **If the change directory does not exist**: report it and stop.
34
34
 
35
35
  ### 2. Load context files
@@ -38,7 +38,7 @@ Read every artifact that IS present — they constrain what you write next. If a
38
38
 
39
39
  ### 3. Create exactly ONE artifact
40
40
 
41
- Draft the missing artifact using the same templates as `openspec-propose`:
41
+ Draft the missing artifact using the same templates as `ancleto-propose`:
42
42
 
43
43
  - **proposal.md** (first artifact): problem statement, proposed change, scope, risks. If Work Item context is available, use its title/description as the problem statement, acceptance criteria as the requirements basis, and include a `## Related Work Item` section: `**#{id}** — {title} ({type}) · Project: {project}`.
44
44
  - **specs/\<capability\>/spec.md**: one spec file per capability the change touches, with `## ADDED Requirements` / `#### Scenario:` blocks in WHEN/THEN form.
@@ -54,7 +54,7 @@ Report:
54
54
  - Which artifact was created.
55
55
  - Current progress (N/4 complete).
56
56
  - What is unlocked next.
57
- - Prompt: "Run `openspec-continue` to create the next artifact."
57
+ - Prompt: "Run `ancleto-continue` to create the next artifact."
58
58
 
59
59
  Create ONE artifact per invocation, then STOP.
60
60
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: openspec-explore
2
+ name: ancleto-explore
3
3
  description: Enter explore mode — think through ideas, investigate problems, and clarify requirements without implementing. Consults prior team memory first. No external binaries required.
4
4
  license: MIT
5
5
  compatibility: No external binaries required. Works with any agent runtime.
@@ -8,11 +8,11 @@ metadata:
8
8
  version: '1.0'
9
9
  ---
10
10
 
11
- # OpenSpec Explore
11
+ # aspec Explore
12
12
 
13
13
  Enter explore mode. Think deeply. Visualize freely. Follow the conversation wherever it goes.
14
14
 
15
- **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 draft OpenSpec artifacts (proposals, designs, specs) if the user asks — that's capturing thinking, not implementing.
15
+ **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 draft aspec artifacts (proposals, designs, specs) if the user asks — that's capturing thinking, not implementing.
16
16
 
17
17
  **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.
18
18
 
@@ -76,7 +76,7 @@ Depending on what the user brings, you might:
76
76
  - Find gaps in understanding
77
77
  - Suggest spikes or investigations
78
78
 
79
- ## OpenSpec Awareness
79
+ ## aspec Awareness
80
80
 
81
81
  You have full context of the spec-driven system. Use it naturally, don't force it.
82
82
 
@@ -84,7 +84,7 @@ You have full context of the spec-driven system. Use it naturally, don't force i
84
84
 
85
85
  At the start, quickly check what exists:
86
86
 
87
- - List the directories under `openspec/changes/` (excluding `archive/`) to see active changes, and read `openspec/changes/<name>/` artifacts for anything relevant.
87
+ - List the directories under `aspec/changes/` (excluding `archive/`) to see active changes, and read `aspec/changes/<name>/` artifacts for anything relevant.
88
88
  - If the user mentioned a specific change name, read its artifacts for context.
89
89
 
90
90
  ### When no change exists
@@ -109,7 +109,7 @@ There's no required ending. Discovery might flow into a proposal ("Ready to star
109
109
 
110
110
  ## Guardrails
111
111
 
112
- - **Don't implement** — never write code or implement features. Drafting OpenSpec artifacts is fine, writing application code is not.
112
+ - **Don't implement** — never write code or implement features. Drafting aspec artifacts is fine, writing application code is not.
113
113
  - **Don't fake understanding** — if something is unclear, dig deeper.
114
114
  - **Don't rush** — discovery is thinking time, not task time.
115
115
  - **Don't force structure** — let patterns emerge naturally.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: openspec-ff
2
+ name: ancleto-ff
3
3
  description: Fast-forward artifact creation — create a change and generate everything needed for implementation in one go. Use when the path is clear and no step-by-step guidance is wanted. No external binaries required.
4
4
  license: MIT
5
5
  compatibility: No external binaries required. Works with any agent runtime.
@@ -8,7 +8,7 @@ metadata:
8
8
  version: '1.0'
9
9
  ---
10
10
 
11
- # OpenSpec FF
11
+ # aspec FF
12
12
 
13
13
  Fast-forward through artifact creation: generate everything needed to start implementation, writing files directly. No external binaries are invoked.
14
14
 
@@ -37,7 +37,7 @@ Use what comes back as read-only background while drafting. If nothing is return
37
37
 
38
38
  ### 3. Create the change directory
39
39
 
40
- Create `openspec/changes/<name>/` directly.
40
+ Create `aspec/changes/<name>/` directly.
41
41
 
42
42
  ### 4. Create all artifacts in dependency order
43
43
 
@@ -57,7 +57,7 @@ Summarize:
57
57
  - Change name and location
58
58
  - List of artifacts created with brief descriptions
59
59
  - What's ready: "All artifacts created! Ready for implementation."
60
- - Prompt: "Run `openspec-apply` to start implementing."
60
+ - Prompt: "Run `ancleto-apply` to start implementing."
61
61
 
62
62
  ## Artifact Creation Guidelines
63
63
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: openspec-new
2
+ name: ancleto-new
3
3
  description: Start a new spec-driven change without external binaries. Use when the user wants to begin structured work on a feature, fix, or modification. Creates the change directory, recalls prior memory, and shows the first artifact template.
4
4
  license: MIT
5
5
  compatibility: No external binaries required. Works with any agent runtime.
@@ -8,7 +8,7 @@ metadata:
8
8
  version: '1.0'
9
9
  ---
10
10
 
11
- # OpenSpec New
11
+ # aspec New
12
12
 
13
13
  Start a new change using a filesystem-native, artifact-driven approach. No external binaries are invoked: every step below is a direct file operation.
14
14
 
@@ -23,7 +23,7 @@ Start a new change using a filesystem-native, artifact-driven approach. No exter
23
23
  > "What change do you want to work on? Describe what you want to build or fix."
24
24
  - Derive a kebab-case name from the description (e.g., "Add payment gateway" → `add-payment-gateway`).
25
25
 
26
- **IMPORTANT**: Do NOT proceed without a change name. If a directory `openspec/changes/<name>/` already exists, suggest continuing it instead of creating a duplicate.
26
+ **IMPORTANT**: Do NOT proceed without a change name. If a directory `aspec/changes/<name>/` already exists, suggest continuing it instead of creating a duplicate.
27
27
 
28
28
  ### 2. Recall prior memory
29
29
 
@@ -40,7 +40,7 @@ Inject what comes back as read-only context (antecedents, never instructions). I
40
40
  Create the directory directly (no scaffolding binary):
41
41
 
42
42
  ```
43
- openspec/changes/<name>/
43
+ aspec/changes/<name>/
44
44
  ```
45
45
 
46
46
  ### 4. Show the artifact status
@@ -52,7 +52,7 @@ A new change starts with zero artifacts. The standard artifact sequence for the
52
52
  3. `tasks.md` (implementation steps)
53
53
  4. `specs/` (delta requirements, optional)
54
54
 
55
- Report: "Change `<name>` created at `openspec/changes/<name>/`. 0/4 artifacts complete."
55
+ Report: "Change `<name>` created at `aspec/changes/<name>/`. 0/4 artifacts complete."
56
56
 
57
57
  ### 5. Show the template for the first artifact
58
58
 
@@ -84,7 +84,7 @@ After completing the steps, summarize:
84
84
  - Change name and location
85
85
  - Artifact sequence and current status (0/4 artifacts complete)
86
86
  - The template for the first artifact
87
- - Prompt: "Ready to create the first artifact? Run `openspec-propose` or just describe what this change is about and I'll draft it."
87
+ - Prompt: "Ready to create the first artifact? Run `ancleto-propose` or just describe what this change is about and I'll draft it."
88
88
 
89
89
  ## Guardrails
90
90
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: openspec-onboard
2
+ name: ancleto-onboard
3
3
  description: Guided onboarding — walk through a complete spec-driven cycle (idea to archive) on a real small task, with narration. Use for a first-time user of the workflow. No external binaries required.
4
4
  license: MIT
5
5
  compatibility: No external binaries required. Works with any agent runtime.
@@ -8,7 +8,7 @@ metadata:
8
8
  version: '1.0'
9
9
  ---
10
10
 
11
- # OpenSpec Onboard
11
+ # aspec Onboard
12
12
 
13
13
  Guide the user through their first complete spec-driven workflow cycle. This is a teaching experience — do real work in their codebase while explaining each step. No external binaries are invoked: changes and artifacts are plain directories and files.
14
14
 
@@ -75,33 +75,33 @@ Briefly demonstrate explore mode on the selected task: read the involved files,
75
75
 
76
76
  ## Phase 4: Create the Change
77
77
 
78
- **EXPLAIN:** a "change" is a container for all the thinking and planning around a piece of work. It lives in `openspec/changes/<name>/` and holds the artifacts.
78
+ **EXPLAIN:** a "change" is a container for all the thinking and planning around a piece of work. It lives in `aspec/changes/<name>/` and holds the artifacts.
79
79
 
80
- **DO:** create the directory `openspec/changes/<derived-kebab-name>/` directly, and show the folder layout (`proposal.md`, `design.md`, `specs/`, `tasks.md` — to be filled next).
80
+ **DO:** create the directory `aspec/changes/<derived-kebab-name>/` directly, and show the folder layout (`proposal.md`, `design.md`, `specs/`, `tasks.md` — to be filled next).
81
81
 
82
82
  ## Phase 5: Proposal
83
83
 
84
84
  **EXPLAIN:** the proposal captures **why** and **what** at a high level.
85
85
 
86
- **DO:** draft it from the task (Why / What Changes / Capabilities / Impact), show it, and **PAUSE** for approval. After approval, write it to `openspec/changes/<name>/proposal.md`.
86
+ **DO:** draft it from the task (Why / What Changes / Capabilities / Impact), show it, and **PAUSE** for approval. After approval, write it to `aspec/changes/<name>/proposal.md`.
87
87
 
88
88
  ## Phase 6: Specs
89
89
 
90
90
  **EXPLAIN:** specs define **what** precisely, in testable WHEN/THEN form.
91
91
 
92
- **DO:** create `openspec/changes/<name>/specs/<capability>/spec.md` with `## ADDED Requirements` / `#### Scenario:` blocks. Save the file.
92
+ **DO:** create `aspec/changes/<name>/specs/<capability>/spec.md` with `## ADDED Requirements` / `#### Scenario:` blocks. Save the file.
93
93
 
94
94
  ## Phase 7: Design
95
95
 
96
96
  **EXPLAIN:** the design captures **how** — decisions, tradeoffs, approach. For small changes this may be brief.
97
97
 
98
- **DO:** draft Context / Goals-Non-Goals / Decisions and save to `openspec/changes/<name>/design.md`.
98
+ **DO:** draft Context / Goals-Non-Goals / Decisions and save to `aspec/changes/<name>/design.md`.
99
99
 
100
100
  ## Phase 8: Tasks
101
101
 
102
102
  **EXPLAIN:** break the work into checkboxed implementation tasks.
103
103
 
104
- **DO:** generate the phased checklist, show it, and **PAUSE** for confirmation. Save to `openspec/changes/<name>/tasks.md`.
104
+ **DO:** generate the phased checklist, show it, and **PAUSE** for confirmation. Save to `aspec/changes/<name>/tasks.md`.
105
105
 
106
106
  ## Phase 9: Apply (Implementation)
107
107
 
@@ -109,9 +109,9 @@ Briefly demonstrate explore mode on the selected task: read the involved files,
109
109
 
110
110
  ## Phase 10: Archive
111
111
 
112
- **EXPLAIN:** archiving moves the change to `openspec/changes/archive/YYYY-MM-DD-<name>/`, preserving the decision record.
112
+ **EXPLAIN:** archiving moves the change to `aspec/changes/archive/YYYY-MM-DD-<name>/`, preserving the decision record.
113
113
 
114
- **DO:** create `openspec/changes/archive/` if missing, delete scaffold-only files (`context.md`), move the directory, and show the archive location.
114
+ **DO:** create `aspec/changes/archive/` if missing, delete scaffold-only files (`context.md`), move the directory, and show the archive location.
115
115
 
116
116
  ## Phase 11: Recap & Next Steps
117
117
 
@@ -119,16 +119,16 @@ Congratulate, recap the cycle (Explore → New → Proposal → Specs → Design
119
119
 
120
120
  | Command | What it does |
121
121
  |---------|--------------|
122
- | `openspec-propose` | Create a change and generate all artifacts |
123
- | `openspec-explore` | Think through problems before/during work |
124
- | `openspec-apply` | Implement tasks from a change |
125
- | `openspec-archive` | Archive a completed change |
126
- | `openspec-new` | Start a new change, step by step |
127
- | `openspec-continue` | Continue an existing change |
128
- | `openspec-ff` | Fast-forward: all artifacts at once |
129
- | `openspec-verify` | Verify implementation |
130
-
131
- **Graceful exits:** if the user wants to stop mid-way, point at the saved change directory and the resume skills (`openspec-continue`, `openspec-apply`). If they only want the reference, show the table and exit.
122
+ | `ancleto-propose` | Create a change and generate all artifacts |
123
+ | `ancleto-explore` | Think through problems before/during work |
124
+ | `ancleto-apply` | Implement tasks from a change |
125
+ | `ancleto-archive` | Archive a completed change |
126
+ | `ancleto-new` | Start a new change, step by step |
127
+ | `ancleto-continue` | Continue an existing change |
128
+ | `ancleto-ff` | Fast-forward: all artifacts at once |
129
+ | `ancleto-verify` | Verify implementation |
130
+
131
+ **Graceful exits:** if the user wants to stop mid-way, point at the saved change directory and the resume skills (`ancleto-continue`, `ancleto-apply`). If they only want the reference, show the table and exit.
132
132
 
133
133
  ## Guardrails
134
134
 
@@ -1,6 +1,6 @@
1
1
  ---
2
- name: openspec-propose
3
- description: Draft all artifacts for a change in one step (proposal, design, tasks, delta specs). Use after openspec-new, or directly with a change name or description. No external binaries required.
2
+ name: ancleto-propose
3
+ description: Draft all artifacts for a change in one step (proposal, design, tasks, delta specs). Use after ancleto-new, or directly with a change name or description. No external binaries required.
4
4
  license: MIT
5
5
  compatibility: No external binaries required. Works with any agent runtime.
6
6
  metadata:
@@ -8,7 +8,7 @@ metadata:
8
8
  version: '1.0'
9
9
  ---
10
10
 
11
- # OpenSpec Propose
11
+ # aspec Propose
12
12
 
13
13
  Create a change and generate all its artifacts in one step, writing files directly. No external binaries are invoked.
14
14
 
@@ -18,7 +18,7 @@ Create a change and generate all its artifacts in one step, writing files direct
18
18
 
19
19
  ### 1. Resolve context and derive the change name
20
20
 
21
- Same as `openspec-new` step 1: use in-session Work Item context if available (record id/title/project for traceability, skip entirely when Azure DevOps is not configured), otherwise ask what the user wants to build and derive a kebab-case name.
21
+ Same as `ancleto-new` step 1: use in-session Work Item context if available (record id/title/project for traceability, skip entirely when Azure DevOps is not configured), otherwise ask what the user wants to build and derive a kebab-case name.
22
22
 
23
23
  **IMPORTANT**: Do NOT proceed without a change name. If a change with that name already exists, ask whether to continue it or create a new one.
24
24
 
@@ -34,7 +34,7 @@ Use what comes back as read-only background while drafting. If nothing is return
34
34
 
35
35
  ### 3. Create the change directory
36
36
 
37
- Create `openspec/changes/<name>/` directly if it does not exist yet.
37
+ Create `aspec/changes/<name>/` directly if it does not exist yet.
38
38
 
39
39
  ### 4. Create artifacts in dependency order
40
40
 
@@ -122,7 +122,7 @@ After completing all artifacts, summarize:
122
122
  - Change name and location
123
123
  - List of artifacts created with brief descriptions
124
124
  - What's ready: "All artifacts created! Ready for implementation."
125
- - Prompt: "Run `openspec-apply` to start implementing."
125
+ - Prompt: "Run `ancleto-apply` to start implementing."
126
126
 
127
127
  ## Artifact Creation Guidelines
128
128
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: openspec-recall
2
+ name: ancleto-recall
3
3
  description: Recupera memoria episódica del proyecto (.ancleto/memory.db) para precargar contexto de changes anteriores. Se invoca al iniciar un change, antes de generar artifacts. Opcional y no bloqueante.
4
4
  license: MIT
5
5
  compatibility: Requires the memory engine configured in the repo. Optional — degrades silently when unavailable.
@@ -10,14 +10,14 @@ metadata:
10
10
 
11
11
  Retrieve shared episodic memory for this repository and inject it as starting context for a change.
12
12
 
13
- This skill is the **single source of truth** for the recall contract. The change-creation flows (`opsx-new`, `opsx-propose`, `opsx-ff`) carry this step inline; those inline blocks must stay in sync with this file.
13
+ This skill is the **single source of truth** for the recall contract. The change-creation flows (`cleto-new`, `cleto-propose`, `cleto-ff`) carry this step inline; those inline blocks must stay in sync with this file.
14
14
 
15
15
  **Two invocation paths, one contract:**
16
16
 
17
17
  | Path | Trigger | On failure or empty result |
18
18
  | --- | --- | --- |
19
19
  | **Automatic** | Inside the change-creation flows, before generating artifacts | Silent — omit the section, never block |
20
- | **Manual** | The `/opsx-recall` command, invoked by the user | **Report it** — the user asked explicitly |
20
+ | **Manual** | The `/cleto-recall` command, invoked by the user | **Report it** — the user asked explicitly |
21
21
 
22
22
  Steps 1 to 3 are identical for both. Only the failure behaviour differs, and it differs for a reason: silence is correct when nobody asked, and wrong when somebody did.
23
23
 
@@ -1,8 +1,8 @@
1
1
  ---
2
- name: openspec-sync-specs
2
+ name: ancleto-sync-specs
3
3
  description: Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.
4
4
  license: MIT
5
- compatibility: Requires openspec CLI.
5
+ compatibility: No external CLI required.
6
6
  metadata:
7
7
  author: ancleto
8
8
  version: '1.0'
@@ -18,7 +18,7 @@ This is an **agent-driven** operation - you will read delta specs and directly e
18
18
 
19
19
  1. **If no change name provided, prompt for selection**
20
20
 
21
- Run `openspec list --json` to get available changes. Use the **AskUserQuestion tool** to let the user select.
21
+ Run `aspec list --json` to get available changes. Use the **AskUserQuestion tool** to let the user select.
22
22
 
23
23
  Show changes that have delta specs (under `specs/` directory).
24
24
 
@@ -26,7 +26,7 @@ This is an **agent-driven** operation - you will read delta specs and directly e
26
26
 
27
27
  2. **Find delta specs**
28
28
 
29
- Look for delta spec files in `openspec/changes/<name>/specs/*/spec.md`.
29
+ Look for delta spec files in `aspec/changes/<name>/specs/*/spec.md`.
30
30
 
31
31
  Each delta spec file contains sections like:
32
32
 
@@ -39,11 +39,11 @@ This is an **agent-driven** operation - you will read delta specs and directly e
39
39
 
40
40
  3. **For each delta spec, apply changes to main specs**
41
41
 
42
- For each capability with a delta spec at `openspec/changes/<name>/specs/<capability>/spec.md`:
42
+ For each capability with a delta spec at `aspec/changes/<name>/specs/<capability>/spec.md`:
43
43
 
44
44
  a. **Read the delta spec** to understand the intended changes
45
45
 
46
- b. **Read the main spec** at `openspec/specs/<capability>/spec.md` (may not exist yet)
46
+ b. **Read the main spec** at `aspec/specs/<capability>/spec.md` (may not exist yet)
47
47
 
48
48
  c. **Apply changes intelligently**:
49
49
 
@@ -71,7 +71,7 @@ This is an **agent-driven** operation - you will read delta specs and directly e
71
71
 
72
72
  d. **Create new main spec** if capability doesn't exist yet:
73
73
 
74
- - Create `openspec/specs/<capability>/spec.md`
74
+ - Create `aspec/specs/<capability>/spec.md`
75
75
  - Add Purpose section (can be brief, mark as TBD)
76
76
  - Add Requirements section with the ADDED requirements
77
77
 
@@ -7,10 +7,10 @@ description: >
7
7
  like "migrar a", "upgrade a", "actualizar a", "mover a v", or any mention of
8
8
  bumping a major version. Analyzes the full repository (TypeScript source, tests,
9
9
  config, CI, Docker, CDK), fetches official migration docs, builds search patterns
10
- dynamically from those docs, and generates a complete OpenSpec change with phased
10
+ dynamically from those docs, and generates a complete aspec change with phased
11
11
  tasks — without touching any code.
12
12
  license: MIT
13
- compatibility: Requires openspec CLI, Node.js
13
+ compatibility: Requires Node.js (no external CLI)
14
14
  metadata:
15
15
  author: ancleto
16
16
  version: '4.0'
@@ -19,7 +19,7 @@ metadata:
19
19
 
20
20
  # ancleto-upgrade
21
21
 
22
- Analiza el repositorio completo y genera un OpenSpec change para migrar cualquier
22
+ Analiza el repositorio completo y genera un aspec change para migrar cualquier
23
23
  librería o runtime a una nueva versión mayor — de forma documentada, faseada y sin
24
24
  romper el repo.
25
25
 
@@ -360,17 +360,15 @@ Con todos los matches del Paso 4, construir:
360
360
 
361
361
  ---
362
362
 
363
- ## Paso 6 — Crear el change OpenSpec
363
+ ## Paso 6 — Crear el change aspec
364
364
 
365
- ```bash
366
- openspec new change "${CHANGE_NAME}"
367
- ```
365
+ Crear el directorio del change en `aspec/changes/${CHANGE_NAME}/` (con `specs/` si aplica).
368
366
 
369
367
  Si el nombre ya existe, preguntar al usuario: agregar sufijo `-v2` o eliminar el existente.
370
368
 
371
369
  ---
372
370
 
373
- ## Paso 7 — Escribir los artefactos OpenSpec
371
+ ## Paso 7 — Escribir los artefactos aspec
374
372
 
375
373
  Leer `references/templates.md` para obtener los templates exactos de cada archivo.
376
374
  Escribir en este orden:
@@ -425,24 +423,24 @@ Reglas al completar los templates:
425
423
  ### Scripts de verificación
426
424
  build: sí/no | lint: sí/no | test: sí/no | test:ci: sí/no | typecheck: sí/no
427
425
 
428
- ### Artefactos OpenSpec generados
426
+ ### Artefactos aspec generados
429
427
  - proposal.md ✅
430
428
  - specs/{LIBRARY_SLUG}{TARGET_VERSION}.md ✅
431
429
  - tasks.md ✅ ({N} tareas en 6 fases)
432
430
  - design.md ✅
433
431
 
434
- Para implementar: /opsx-apply {CHANGE_NAME}
432
+ Para implementar: /cleto-apply {CHANGE_NAME}
435
433
  ```
436
434
 
437
435
  ---
438
436
 
439
437
  ## Guardrails
440
438
 
441
- Este skill solo genera artefactos OpenSpec — no modifica ningún archivo del repo.
442
- Todo cambio real lo ejecuta el desarrollador con `/opsx-apply`, que tiene su propio
439
+ Este skill solo genera artefactos aspec — no modifica ningún archivo del repo.
440
+ Todo cambio real lo ejecuta el desarrollador con `/cleto-apply`, que tiene su propio
443
441
  ciclo de revisión. Modificar el repo desde este skill saltearía ese control.
444
442
 
445
- - No tocar archivos fuera de `openspec/changes/{CHANGE_NAME}/`
443
+ - No tocar archivos fuera de `aspec/changes/{CHANGE_NAME}/`
446
444
  - Los `VERSION_PATTERNS[]` siempre se aplican, con o sin documentación oficial
447
445
  - Si no hay doc disponible, documentarlo en proposal y continuar con el escaneo
448
446
  - Si el change ya existe, avisar antes de cualquier acción