akili-specs 2.7.0 → 2.7.1
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.
- package/.claude/commands/akili-archive.md +9 -0
- package/.claude/commands/akili-audit.md +9 -0
- package/.claude/commands/akili-constitution.md +9 -0
- package/.claude/commands/akili-execute.md +9 -0
- package/.claude/commands/akili-propose.md +9 -0
- package/.claude/commands/akili-quick.md +9 -0
- package/.claude/commands/akili-resume.md +9 -0
- package/.claude/commands/akili-seo.md +9 -0
- package/.claude/commands/akili-specify.md +9 -0
- package/.claude/commands/akili-test.md +9 -0
- package/.claude/commands/akili-validate.md +9 -0
- package/.claude/templates/implementer.md +6 -0
- package/.claude/templates/leader.md +6 -0
- package/.claude/templates/reviewer.md +6 -0
- package/.claude/templates/tester.md +6 -0
- package/CHANGELOG.md +8 -0
- package/LICENSE +1 -1
- package/README.md +6 -0
- package/package.json +3 -2
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Archive a completed spec task, run the Kaizen retrospective, sync agent guides and CodeGraph, and keep the TRD current.
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# Archive AKILI-SPECS Spec
|
|
@@ -174,3 +177,9 @@ Present:
|
|
|
174
177
|
- Do not delete spec folders as part of archiving; only move them into `docs/specs/archive/`.
|
|
175
178
|
- The Kaizen retrospective must never block the archive. If retrospective inputs are missing or the user declines, append a metrics-only (or clean-run) entry to `docs/specs/kaizen-log.md` and continue to Step 5.
|
|
176
179
|
- Never edit files outside `docs/specs/kaizen-log.md` without explicit user approval in Step 4.3.
|
|
180
|
+
|
|
181
|
+
---
|
|
182
|
+
|
|
183
|
+
## Authorship
|
|
184
|
+
|
|
185
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Run spec-to-code drift auditing to detect differences between active codebase reality and the active UX/UI design and TRD.
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# Audit AKILI Specifications for Drift
|
|
@@ -95,3 +98,9 @@ Summarize the conformance score, key discrepancies found, and recommended remedi
|
|
|
95
98
|
1. Fix documented specs (update baseline docs in place).
|
|
96
99
|
2. Schedule task specs to implement missing functionality in the code.
|
|
97
100
|
3. Keep the report for review.
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## Authorship
|
|
105
|
+
|
|
106
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Establish or strengthen the project-wide AKILI-SPECS foundation and baseline docs (PRD, UX/UI Design, TRD).
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# Establish AKILI-SPECS Constitution
|
|
@@ -418,3 +421,9 @@ Ask the user whether to approve or request changes. If changes are requested, re
|
|
|
418
421
|
## Outcome
|
|
419
422
|
|
|
420
423
|
At the end of `/akili-constitution`, the repository should have a project-level baseline that future `/akili-specify`, `/akili-execute`, `/akili-validate`, and `/akili-test` work can rely on without guessing the structure or conventions. The `.agents/` personas must be in place so that `/akili-execute` can run the Leader → Implementer → Reviewer rework loop and `/akili-test` can run the Leader → Tester(s) harness without falling back to inline personas. The root guides must also carry a `## Model Routing` registry (Step 8C) so each phase runs on a model matched to its demand, with the Reviewer on a different model than the Implementer.
|
|
424
|
+
|
|
425
|
+
---
|
|
426
|
+
|
|
427
|
+
## Authorship
|
|
428
|
+
|
|
429
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Execute approved specs systematically following the AKILI-SPECS methodology with spec-to-code traceability.
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# Execute AKILI-SPECS Tasks
|
|
@@ -240,3 +243,9 @@ A minimal PASS-on-first-attempt entry can be compact; a HALT or rework entry mus
|
|
|
240
243
|
2. Document the blocker, alternatives, and revised technical direction in `execution.md` inside a new `## Pivot Record: <Task ID>` section.
|
|
241
244
|
3. Modify the spec's `requirements.md`, `design.md`, and/or `tasks.md` to map out the updated plan.
|
|
242
245
|
4. Stop, explain the situation to the user, and obtain explicit review/approval on the pivot before resuming execution.
|
|
246
|
+
|
|
247
|
+
---
|
|
248
|
+
|
|
249
|
+
## Authorship
|
|
250
|
+
|
|
251
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Propose new features or changes by initiating a new detailed technical spec process.
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# Propose AKILI-SPECS Change
|
|
@@ -251,3 +254,9 @@ Generate a short, easy-to-understand summary (summary facil de entender de lo qu
|
|
|
251
254
|
7. next command to run after approval (matched to the type)
|
|
252
255
|
|
|
253
256
|
Ask whether to approve the proposal, revise it, or stop.
|
|
257
|
+
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
## Authorship
|
|
261
|
+
|
|
262
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Fast-track a trivial, low-risk change (copy edit, color tweak, small style/text change) with minimal traceability and automatic escalation when it is not actually trivial.
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# Fast-Track a Trivial AKILI-SPECS Change
|
|
@@ -123,3 +126,9 @@ Generate a short, easy-to-understand summary (summary facil de entender de lo qu
|
|
|
123
126
|
- One change per invocation. Batch unrelated tweaks into separate `/akili-quick` runs or a proper spec.
|
|
124
127
|
- When in doubt about triviality, escalate. A wrongly fast-tracked change costs more than a Lite spec.
|
|
125
128
|
- Keep the edit and the context minimal — this command's whole value is speed and low token cost.
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## Authorship
|
|
133
|
+
|
|
134
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Resume work after a session break by scanning active specs and presenting a multi-spec dashboard briefing.
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# Resume AKILI-SPECS Session
|
|
@@ -124,3 +127,9 @@ No files are created or modified. The command outputs a screen summary only.
|
|
|
124
127
|
- If `docs/specs/` does not exist, report that the project has no active specs and suggest running `/akili-constitution` or `/akili-propose`.
|
|
125
128
|
- If `docs/specs/` is empty (only `archive/` exists), report that all specs are archived and suggest running `/akili-propose` for new work.
|
|
126
129
|
- If a spec folder exists but has no readable files, report it as an incomplete spec and suggest running `/akili-specify <spec-path>`.
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## Authorship
|
|
134
|
+
|
|
135
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Enhance pages and search engine optimization following SEO best practices.
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# SEO Setup & Audit via Google Search Console
|
|
@@ -275,3 +278,9 @@ After the command completes, verify:
|
|
|
275
278
|
- If `search_analytics_query` returns no rows for a newly verified property, this is expected. Do not mark as failure.
|
|
276
279
|
- If the Indexing API is suggested as a fix, decline it for non-`JobPosting`/`BroadcastEvent` content and explain why.
|
|
277
280
|
- If a skill is unavailable, fall back to the next documented skill and note it in the report.
|
|
281
|
+
|
|
282
|
+
---
|
|
283
|
+
|
|
284
|
+
## Authorship
|
|
285
|
+
|
|
286
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Draft detailed requirements, UI/UX designs, and technical tasks for a proposed feature.
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# Generate AKILI-SPECS for Module
|
|
@@ -334,3 +337,9 @@ When the spec is ready, generate a short, easy-to-understand summary (summary fa
|
|
|
334
337
|
7. Open questions or assumptions that still need user confirmation
|
|
335
338
|
|
|
336
339
|
If a proposal existed, mention whether the generated spec stayed aligned with it or changed based on implementation discovery.
|
|
340
|
+
|
|
341
|
+
---
|
|
342
|
+
|
|
343
|
+
## Authorship
|
|
344
|
+
|
|
345
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Write and execute comprehensive automated unit/integration tests for the implemented feature.
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# Test AKILI-SPECS Implementation
|
|
@@ -174,3 +177,9 @@ If `ui-ux-pro-max` is unavailable, use `frontend-design` plus the UX/UI design d
|
|
|
174
177
|
- If no automated test is practical, document the manual verification steps and why automation was deferred.
|
|
175
178
|
- A Tester must never rewrite a test to hide a genuine product defect; a real failure is reported as `PRODUCT_BUG`, not silenced.
|
|
176
179
|
- Do not delegate trivial single-test work to a subagent when running it inline is cheaper (see the Deployment Rule).
|
|
180
|
+
|
|
181
|
+
---
|
|
182
|
+
|
|
183
|
+
## Authorship
|
|
184
|
+
|
|
185
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Validate that the implemented feature strictly matches all requirements, design tokens, and user flows.
|
|
3
|
+
license: MIT
|
|
4
|
+
metadata:
|
|
5
|
+
author: Juan Carlos Cadavid (jcadavid.com)
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
# Validate AKILI-SPECS Implementation
|
|
@@ -184,3 +187,9 @@ The work is ready to consider complete when:
|
|
|
184
187
|
- tests cover the key requirements and scenarios
|
|
185
188
|
- implementation drift is reflected in the AKILI-SPECS docs or execution notes
|
|
186
189
|
- the user has reviewed the validation summary
|
|
190
|
+
|
|
191
|
+
---
|
|
192
|
+
|
|
193
|
+
## Authorship
|
|
194
|
+
|
|
195
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -34,3 +34,9 @@ When you finish implementing and verifying your task, provide a concise response
|
|
|
34
34
|
1. **Task Completed:** (Brief 1-sentence summary of what you implemented)
|
|
35
35
|
2. **Verification Command Run:** (e.g. `npm run test` or `vitest run`)
|
|
36
36
|
3. **Verification Output/Evidence:** (Paste passing test outputs or compile success logs)
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## Authorship
|
|
41
|
+
|
|
42
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -75,3 +75,9 @@ After each task completes (whether on first pass or after self-correction), repo
|
|
|
75
75
|
6. **Next step:** the next eligible task and a prompt to continue, pause, or skip.
|
|
76
76
|
|
|
77
77
|
Keep this report concise. The full audit trail belongs in `execution.md`, not in chat.
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Authorship
|
|
82
|
+
|
|
83
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -51,3 +51,9 @@ Use this ONLY if you detect a critical architectural violation, the introduction
|
|
|
51
51
|
STATUS: FATAL_FAIL
|
|
52
52
|
SUMMARY: (Clear explanation of the catastrophic failure and why the loop must be aborted)
|
|
53
53
|
```
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Authorship
|
|
58
|
+
|
|
59
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
|
@@ -72,3 +72,9 @@ BUG:
|
|
|
72
72
|
- **Failing Test:** (test file::test name — kept red on purpose)
|
|
73
73
|
- **Observed vs Expected:** (actual behavior vs the required behavior)
|
|
74
74
|
```
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## Authorship
|
|
79
|
+
|
|
80
|
+
AKILI-SPECS methodology by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com). Licensed under the MIT License.
|
package/CHANGELOG.md
CHANGED
|
@@ -10,6 +10,14 @@ The format is inspired by Keep a Changelog and the repository follows semantic v
|
|
|
10
10
|
|
|
11
11
|
- No unreleased changes yet.
|
|
12
12
|
|
|
13
|
+
## [2.7.1] - 2026-07-20
|
|
14
|
+
|
|
15
|
+
### Added
|
|
16
|
+
|
|
17
|
+
- **Authorship section in commands and templates:** Every command in `.claude/commands/` and every agent role template in `.claude/templates/` now ends with an `## Authorship` section crediting the AKILI-SPECS methodology to Juan Carlos Cadavid ([jcadavid.com](https://jcadavid.com)).
|
|
18
|
+
- **Authorship in README, LICENSE, and package metadata:** The README gains an `## Authorship` section, the MIT LICENSE copyright line uses the full author name and site, and `package.json` declares the `author` field.
|
|
19
|
+
- **License metadata in commands:** Every command in `.claude/commands/` declares `license: MIT` and `metadata.author` in its frontmatter (matching the convention used by community skills), and the `## Authorship` footer of commands and templates states the MIT License. Third-party skills bundled in `.claude/skills/` keep their original authors and licenses untouched.
|
|
20
|
+
- **Community governance files:** `CONTRIBUTING.md` (PR-only workflow, changelog discipline, and security rules for editing agent-executed prompt files), `SECURITY.md` (private vulnerability reporting with prompt-injection and installer threat scope), and `.github/CODEOWNERS` (maintainer review required on every change).
|
|
13
21
|
## [2.7.0] - 2026-07-20
|
|
14
22
|
|
|
15
23
|
### Added
|
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -832,3 +832,9 @@ and the default registry for Claude Code (PRO) and OpenCode Go.
|
|
|
832
832
|
- Skills were copied with their bundled references and helper assets.
|
|
833
833
|
- This repository stores the current methodology baseline so it can be reused or versioned independently.
|
|
834
834
|
- Dotfiles are snapshots of the working environment and may include plugin source copies for portability.
|
|
835
|
+
|
|
836
|
+
## Authorship
|
|
837
|
+
|
|
838
|
+
The AKILI-SPECS methodology is created and maintained by **Juan Carlos Cadavid** — [jcadavid.com](https://jcadavid.com).
|
|
839
|
+
|
|
840
|
+
Every command in `.claude/commands/` and every agent role template in `.claude/templates/` carries this authorship notice. The project is released under the [MIT License](LICENSE): you are free to use, modify, and redistribute it, provided the copyright and attribution notices are kept intact.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "akili-specs",
|
|
3
|
-
"version": "2.7.
|
|
3
|
+
"version": "2.7.1",
|
|
4
4
|
"description": "Portable AKILI-SPECS methodology commands and skills for AI-assisted development.",
|
|
5
5
|
"homepage": "https://github.com/JuankCadavid/akili-specs#readme",
|
|
6
6
|
"repository": {
|
|
@@ -46,5 +46,6 @@
|
|
|
46
46
|
"engines": {
|
|
47
47
|
"node": ">=18.0.0"
|
|
48
48
|
},
|
|
49
|
-
"license": "MIT"
|
|
49
|
+
"license": "MIT",
|
|
50
|
+
"author": "Juan Carlos Cadavid (https://jcadavid.com)"
|
|
50
51
|
}
|