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.
@@ -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
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 Juan Cadavid
3
+ Copyright (c) 2026 Juan Carlos Cadavid (jcadavid.com)
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
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.0",
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
  }