@lab43/q 0.6.0 → 0.6.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lab43/q",
3
- "version": "0.6.0",
3
+ "version": "0.6.1",
4
4
  "description": "An agentic coding workflow framework: skills for planning, implementing, verifying, and grooming, grounded in per-project conventions docs.",
5
5
  "q": {
6
6
  "description": "The rules of the q workflow, governing how a project's work gets planned, decided, documented, and shipped."
@@ -2,7 +2,7 @@
2
2
  "name": "q",
3
3
  "displayName": "q",
4
4
  "description": "An agentic coding workflow framework: skills for planning, implementing, verifying, and grooming, grounded in per-project conventions docs.",
5
- "version": "0.6.0",
5
+ "version": "0.6.1",
6
6
  "author": { "name": "Cameron Spencer", "email": "cameron@lab43.com" },
7
7
  "license": "MIT"
8
8
  }
@@ -1,6 +1,6 @@
1
1
  # Conventions
2
2
 
3
- Rules for a project's conventions docs: the tiers they come in and which tier wins, what a conventions doc holds, and when a rule leaves prose for a stronger enforcement rung.
3
+ Rules for how a project's conventions are tiered, written, and enforced.
4
4
 
5
5
  ## Three tiers of conventions
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Plans
2
2
 
3
- Format, sequencing, and lifecycle rules for `docs/plans/` documents. `/q:create-plan` writes to this rubric and its adversarial plan reviews enforce it; `/q:implement-plan` executes the delivery shape the plan records.
3
+ Rules for how a project's plans are written, sequenced, and carried to completion. `/q:create-plan` writes to this rubric and its adversarial plan reviews enforce it. `/q:implement-plan` executes the delivery shape the plan records.
4
4
 
5
5
  ## Audience
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Specs
2
2
 
3
- Rules for `docs/specs/` documents: what a spec holds, how it is written, and how the code is held to it. A spec states what the product commits to. Whether a rule is a spec's or a convention's is the taxonomy's call (see: @lab43/q conventions/documentation.md, Taxonomy).
3
+ Rules for how a project's specs are written and how the code is held to them. A spec states what the product commits to. Whether a rule is a spec's or a convention's is the taxonomy's call (see: @lab43/q conventions/documentation.md, Taxonomy).
4
4
 
5
5
  ## Format
6
6
 
@@ -13,7 +13,7 @@ This project follows q, an agentic coding workflow. Its rules live in the projec
13
13
 
14
14
  If the session's skill list has no `/q:` skills, this machine is missing the q plugin — ask the user to install the project's dependencies (`npm install`, or the project's package manager's equivalent), then run `/q:reconcile`.
15
15
 
16
- When another session is already working this repo, take a worktree rather than sharing the checkout.
16
+ When another session is already working this repo, take a worktree rather than sharing the checkout (source: @lab43/q references/run-contract.md, The delivery branch).
17
17
 
18
18
  Conventions come in three tiers: q's own, the conventions of any installed extensions, and this project's own `docs/conventions/` (source: @lab43/q conventions/conventions.md, Three tiers of conventions). q and the extensions are dependencies in `package.json`. Project rules win over an extension's rule, and an extension's rule wins over q's. Check all three tiers before writing code, before design decisions and reviews, and before changing docs. Doc changes — the README and this briefing itself included — go through `/q:update-docs`.
19
19
 
@@ -23,10 +23,10 @@ Package doc paths are package name plus path from the package's `q-extension/` p
23
23
 
24
24
  - `@lab43/q conventions/principles.md` — cross-cutting rules for any design decision, plan, or review
25
25
  - `@lab43/q conventions/documentation.md` — what belongs in a project's documentation, where it lives, and how it stays accurate
26
- - `@lab43/q conventions/conventions.md` — rules for a project's conventions docs: the tiers they come in and which tier wins, what a conventions doc holds, and when a rule leaves prose for a stronger enforcement rung
26
+ - `@lab43/q conventions/conventions.md` — how a project's conventions are tiered, written, and enforced
27
27
  - `@lab43/q conventions/extensions.md` — the extension format: rules for authoring and publishing a q extension
28
- - `@lab43/q conventions/plans.md` — format, sequencing, and lifecycle rules for `docs/plans/` documents
29
- - `@lab43/q conventions/specs.md` — rules for `docs/specs/` documents: what a spec holds, how it is written, and how the code is held to it
28
+ - `@lab43/q conventions/plans.md` — how a project's plans are written, sequenced, and carried to completion
29
+ - `@lab43/q conventions/specs.md` — how a project's specs are written and how the code is held to them
30
30
  - `@lab43/q conventions/issue-tracking.md` — rules for working a project's issue tracker from any session
31
31
  - `@lab43/q conventions/pull-requests.md` — rules for authoring a pull request
32
32
  - `@lab43/q conventions/writing.md` — rules for writing prose: docs, plans, PR bodies, anything a human or agent will read
@@ -97,7 +97,7 @@ The invocation is the agreement — scaffold autonomously; on a fully set-up, un
97
97
  8. **The README's q section** — when the README doesn't mention q, add this section verbatim:
98
98
 
99
99
  ```markdown
100
- ## Claude Code
100
+ ## Working with q
101
101
 
102
102
  This project uses [q](https://www.npmjs.com/package/@lab43/q), an agentic coding workflow that grounds Claude Code sessions in the project's own conventions. It arrives with the project's dependencies, and Claude Code loads it from the repo's tracked settings.
103
103