Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
37 commits
Select commit Hold shift + click to select a range
58e2707
docs(working-process): process-setup spec and plan implemented
vircung Sep 29, 2026
c4b4193
fix: forbid agents from reading or passing credential values
vircung Oct 27, 2026
ba6e787
chore: enable the ponytail plugin in project settings
vircung Oct 27, 2026
a682108
feat(working-process): name new documents by ticket or date, topic an…
vircung Oct 27, 2026
5861000
docs: ticket directories spec and glossary terms
vircung Oct 27, 2026
b93b539
docs: ticket directories spec, architect round 1 fixes
vircung Oct 27, 2026
1e93343
docs: ticket directories spec, architect round 2 fixes and branch scheme
vircung Oct 27, 2026
8a096f7
docs: ticket directories spec, confirm a branch ticket without a dire…
vircung Oct 27, 2026
021450e
docs: ticket directories spec, architect round 3 fixes
vircung Oct 27, 2026
c64dff5
docs: ticket directories spec, architect round 4 fixes
vircung Oct 27, 2026
42059a2
docs: ticket directories spec, integrity audit dispositions
vircung Oct 27, 2026
70fd8b8
docs: ticket directories spec, audit closures
vircung Oct 27, 2026
b585f12
docs: ticket directories plan
vircung Oct 27, 2026
bad62a2
docs: ticket directories plan, adversary round 1 fixes
vircung Oct 27, 2026
3133033
docs: ticket directories plan, adversary round 2 fixes
vircung Oct 27, 2026
75f5f92
docs: ticket directories plan, a diff for each dogfood review
vircung Oct 27, 2026
eb67da1
feat(working-process): ticket.root settings key with a path value
vircung Oct 27, 2026
2bdd7d0
feat(working-process): decision coverage recognises a technical desig…
vircung Oct 27, 2026
ead24d8
feat(working-process): ticket directories in the document rules
vircung Oct 27, 2026
1aa7dbd
feat(working-process): move a document into a ticket directory
vircung Oct 27, 2026
e1c013b
fix(working-process): move procedure checks hashes before the rewrite
vircung Oct 27, 2026
3d15d39
feat(working-process): ticket placement and the branch scheme in the …
vircung Oct 27, 2026
86e8748
fix(working-process): point the flow steps at the ticket-directory cl…
vircung Oct 27, 2026
73e64b9
feat(working-process): ticket-frontmatter for ticket directories
vircung Oct 27, 2026
ef832fa
fix(working-process): a declined ticket-directory confirmation falls …
vircung Oct 27, 2026
433d47b
feat(working-process): review reports in ticket directories
vircung Oct 27, 2026
559870f
feat: standards review commands place reports in ticket directories
vircung Oct 27, 2026
8ac90d5
fix: standards review commands send local-only reviews to docs/code-r…
vircung Oct 27, 2026
d39ac59
fix: standards review commands check local-only before the ticket branch
vircung Oct 27, 2026
473a784
docs: changelog entries for ticket directories
vircung Oct 27, 2026
0078f5e
fix(working-process): scope the status gate to ticket.root, name tick…
vircung Oct 27, 2026
0a35325
docs: scope the status gate to ticket.root in the spec and glossary
vircung Oct 27, 2026
d0b2dbe
docs(working-process): ticket directories spec and plan implemented
vircung Oct 27, 2026
68f8e0a
Merge branch 'feature/ticket-directories' into develop
vircung Oct 27, 2026
8c53b63
chore(working-process): dogfooding version for ticket directories
vircung Oct 27, 2026
fad6793
chore: dogfooding versions for ticket directories - python-standards,…
vircung Oct 27, 2026
fa0ff86
chore: mint release versions - working-process 0.19.0, python-standar…
vircung Nov 13, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion .claude/settings.json
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,8 @@
},
"enabledPlugins": {
"superpowers@claude-plugins-official": true,
"elements-of-style@superpowers-marketplace": true
"elements-of-style@superpowers-marketplace": true,
"ponytail@ponytail": true
},
"extraKnownMarketplaces": {
"claude-plugins-official": {
Expand All @@ -37,6 +38,12 @@
"source": "github",
"repo": "obra/superpowers-marketplace"
}
},
"ponytail": {
"source": {
"source": "github",
"repo": "DietrichGebert/ponytail"
}
}
}
}
50 changes: 46 additions & 4 deletions docs/domain/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,32 @@ artifacts (e.g. `docs/domain/`, `docs/specs/`, `docs/plans/`). Deliberately
narrow: configuration directories the process may also create (such as
`.claude/rules/` during a project-level rules install) are not Process
directories — their install questions are their own, defined where the
install is specified.
install is specified. A ticket root and its ticket directories are not
Process directories either.
_Avoid_: artifact folder

**Ticket root**:
The directory under `docs/` that a project names in the `ticket.root`
settings key, which holds the ticket directories. The
process asks no mode question for it and writes no `.gitignore` there;
what the project's own ignore rules exclude inside it, the process
respects and may still use.
_Avoid_: tickets folder, jira directory

**Ticket directory**:
The directory one level below the ticket root that holds one ticket's
work — its process documents, code-review reports and companion
documents — named `<prefix>-<topic>` by the ticket's key. One ticket has
exactly one.
_Avoid_: ticket folder, ticket workspace

**Companion document**:
A file in a ticket directory that is not a process document or a review
report — an analysis, a brief, a runbook, a data file. It needs no
process frontmatter, may carry its own, and the process leaves it
untouched.
_Avoid_: supporting document, attachment, ticket document

**First-create question**:
The question — ignored mode or tracked mode — asked when a process
directory is created for the first time, or exists with no prior
Expand Down Expand Up @@ -103,7 +126,8 @@ _Avoid_: index check, store check

**Review report**:
The single persistent document one code-review run writes under
`docs/code-review/` of the reviewed project — one run, one report,
`docs/code-review/` of the reviewed project, or under a ticket
directory's `code-review/` — one run, one report,
written by the run's owner. Shape defined by the review-reports rule's
contract; a domain plugin's inline fallback is a strict subset of it,
never a different shape.
Expand Down Expand Up @@ -246,9 +270,27 @@ or a technical design, each read next by the plan-writer and the
plan-adversary — as against an implementation plan, whose next reader
only executes it. The class decides which ceremonies a document owes
(ADR 0004), so the lifecycle rule branches on it rather than on a
filename.
filename; a class suffix only detects the class.
_Avoid_: design document

**Process document**:
A design spec, technical design or implementation plan — a document the
lifecycle rule governs. Under `docs/` it is recognised by its class
suffix or its class directory, and with `ticket.root` set, together
with a frontmatter `status:`; a file with the suffix alone is not one —
in a ticket directory, it is a companion document.
_Avoid_: lifecycle document, judged document (for a plan)

**Class suffix**:
The ending of a process document's file name — `-spec`, `-technical-design`
or `-plan` — that detects its class wherever the file lies.
_Avoid_: type suffix, kind suffix

**Class directory**:
One of `docs/specs/`, `docs/technical-designs/` and `docs/plans/`, the
directory a process document lives in when it has no ticket directory.
_Avoid_: type directory, document folder

**Part**:
A unit of a design with a resolvable identity, an explicit
responsibility and its exclusions, and a contract that lets its
Expand Down Expand Up @@ -582,7 +624,7 @@ git-ignored, and NOT a Process directory — a per-checkout store under
the `.claude/` config namespace, as Private memory is a per-user one. It
survives compaction, the session's end and a branch switch, and no more:
that bound is what lets a Relay condense. Never a Review report, the
counted document a code-review run writes under `docs/code-review/`.
counted document one code-review run writes.
_Avoid_: dispatch log, transcript file

**Session skill**:
Expand Down
2 changes: 1 addition & 1 deletion docs/plans/2026-09-28-process-setup.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
ticket: none
date: 2026-09-28
status: approved
status: implemented
adversary: concerns (resolved 2026-09-29)
spec: ../specs/2026-09-28-process-setup-design.md
branch: feature/process-setup
Expand Down
Loading
Loading