Skip to content

Commit 706434d

Browse files
committed
fix: v0.11.1 — pascal/camel as distinct styles, context/ mirror sync
- ids.py: pascal → PascalCase (BoldVale), camel → true camelCase (boldVale). Previously camel incorrectly generated PascalCase. - settings.toml updated to word_style = "pascal" - context/ dogfood mirror synced: resolve_entity(), MCP server partial-ID lookups, session-handover SKILL.md, INDEX.md expansion - aibox.lock bumped to v0.17.12 / processkit v0.10.0 - Templates mirror: context/templates/processkit/v0.10.0/ added Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 924e339 commit 706434d

354 files changed

Lines changed: 51260 additions & 168 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -263,7 +263,7 @@ call — no restart needed.
263263

264264
| Preference | Value |
265265
|---|---|
266-
| ID word-pair style | `camel` — e.g. `BoldVale` |
266+
| ID word-pair style | `pascal` — e.g. `BoldVale` (also: `camel``boldVale`, `kebab``bold-vale`) |
267267
| ID datetime prefix | enabled — format `YYYYMMDD_HHMM` embedded in ID |
268268
| ID slug | enabled — content-derived from entity title |
269269
| Example ID | `BACK-20260409_1449-BoldVale-fts5-full-text-search` |

CHANGELOG.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,31 @@ Versions follow [Semantic Versioning](https://semver.org/).
55

66
---
77

8+
## [v0.11.1] — 2026-04-11
9+
10+
### Fixed
11+
12+
- **`ids.py`: `pascal` and `camel` are now distinct word styles**
13+
`pascal` produces PascalCase (`BoldVale`, every word capitalised);
14+
`camel` now correctly produces true camelCase (`boldVale`, first word
15+
lowercase). Previously `camel` incorrectly generated PascalCase.
16+
`id-management/config/settings.toml` updated to `word_style = "pascal"`.
17+
18+
### Changed
19+
20+
- **`context/` dogfood mirror synced**`resolve_entity()` and
21+
partial-ID lookup now live in the installed `context/` copies of
22+
`index.py` and all MCP servers, consistent with the `src/`
23+
implementation shipped in v0.10.0.
24+
- **`session-handover` SKILL.md** — log-entry writing steps updated
25+
with `generate_id` call, date-sharded path derivation, and word-pair
26+
ID template.
27+
- **`context/skills/INDEX.md`** — expanded with skill package layout
28+
section and `_lib/` note.
29+
- **`aibox.lock`** — updated to aibox v0.17.12, processkit v0.10.0.
30+
31+
---
32+
833
## [v0.11.0] — 2026-04-11
934

1035
### Added

HANDOVER.md

Lines changed: 0 additions & 60 deletions
This file was deleted.

^

Lines changed: 0 additions & 39 deletions
This file was deleted.

aibox.lock

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
[aibox]
2-
cli_version = "0.17.11"
3-
synced_at = "2026-04-10T12:38:48.050448+00:00"
2+
cli_version = "0.17.12"
3+
synced_at = "2026-04-10T21:51:18.112494+00:00"
44

55
[processkit]
66
source = "https://github.com/projectious-work/processkit.git"
7-
version = "v0.8.0"
7+
version = "v0.10.0"
88
src_path = "src"
9-
release_asset_sha256 = "dbd0639aac7f2ac49708e770415a4d49b85ac2838df534a6e85a98b18b75697b"
10-
installed_at = "2026-04-10T12:38:48.050448+00:00"
9+
release_asset_sha256 = "93394a9bd73243dfa7ec273b3169d8bb77a28763995ad9fc88e88c152d96b965"
10+
installed_at = "2026-04-10T21:51:18.112494+00:00"
Lines changed: 123 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
---
2+
apiVersion: processkit.projectious.work/v1
3+
kind: Discussion
4+
metadata:
5+
id: DISC-20260411_0044-ClearKeel-context-structure-primitive-taxonomy
6+
created: '2026-04-11T00:44:00+00:00'
7+
updated: '2026-04-11T00:44:00+00:00'
8+
spec:
9+
question: How should the context/ directory, primitive taxonomy, and Zettelkasten
10+
linking be structured and clarified in processkit?
11+
state: resolved
12+
opened_at: '2026-04-11T00:44:00+00:00'
13+
closed_at: '2026-04-11T00:44:00+00:00'
14+
participants:
15+
- ACTOR-claude
16+
- ACTOR-owner
17+
outcomes: []
18+
---
19+
20+
## Driving questions
21+
22+
1. Why do agents create free-form files instead of using skills/MCP tools?
23+
2. Where do team descriptions, work instructions, PRDs, and research
24+
results belong?
25+
3. What is the difference between an Artifact, a Work Instruction, and
26+
a Note?
27+
4. What directory structure should `context/` have, and why does
28+
`discussions/` exist as a top-level directory?
29+
5. Should Note be a separate primitive or a subtype of Artifact?
30+
6. Are Artifact entities pointers or self-hosted documents?
31+
7. Is the Zettelkasten linking mechanism (qualified note-to-note links)
32+
missing from the Note schema?
33+
34+
## Resolutions
35+
36+
### R1 — AGENTS.md bloat is an antipattern
37+
Keep AGENTS.md as complete as necessary but as lean as possible.
38+
It should contain only what an agent needs at session start that
39+
cannot be derived from the project structure or entities. Anything
40+
with its own lifecycle, owner, or update cadence belongs in an
41+
entity.
42+
43+
### R2 — Team configuration belongs in Actor entity files
44+
Model, role (PM vs developer), and parallelism pattern for AI actors
45+
belong in their Actor entity files — not in AGENTS.md. Actor profiles
46+
have their own update cycle; duplicating this in AGENTS.md causes
47+
immediate drift.
48+
49+
### R3 — Work instructions are Artifacts
50+
A project-specific operational document (asciinema recording guide,
51+
release procedure variant) is a `kind: document` Artifact. No new
52+
primitive is needed. For formal repeatable processes, use a Process
53+
entity in `context/processes/`.
54+
55+
### R4 — Artifact schema should acknowledge self-hosted content
56+
The schema description ("processkit does not store artifact content
57+
itself; just the pointer") is inconsistent with actual usage (the
58+
PRD artifact stores its full content inline). The schema should
59+
acknowledge two valid patterns:
60+
- **Self-hosted**: Markdown body after frontmatter; `location` may
61+
self-reference or be omitted.
62+
- **Pointer**: deliverable lives elsewhere; `location` is the URL,
63+
path, or storage ID.
64+
65+
### R5 — Note state machine justifies keeping it separate from Artifact
66+
Notes have lifecycle mechanics (state machine, `review_due`,
67+
`promotes_to`) that Artifacts lack. These mechanics are what make
68+
the Zettelkasten capture-and-promote workflow function. Merging Note
69+
into Artifact would require adding optional lifecycle fields to
70+
Artifact, changing its character for non-note uses. Note stays a
71+
separate primitive, but the schemas should cross-reference the
72+
distinction explicitly.
73+
74+
### R6 — Notes are not ephemeral; the type taxonomy needs alignment
75+
In Luhmann/Ahrens, permanent notes are never discarded — they are
76+
the knowledge base. The current `type` enum (fleeting, insight,
77+
reference, question) approximates but does not cleanly map to the
78+
three canonical types (fleeting, literature, permanent). The mapping
79+
should be made explicit in the schema description.
80+
81+
### R7 — Qualified links are missing from the Note schema
82+
The Zettelkasten insight-generation mechanism depends on qualified
83+
note-to-note links, not just tags. Tags are for categorical
84+
discovery; links with context are for reasoning. The Note schema
85+
needs a `links` field:
86+
87+
```yaml
88+
links:
89+
- target: NOTE-xxx-yyy
90+
relation: elaborates # elaborates | contradicts | supports |
91+
# is-example-of | see-also | refines |
92+
# sourced-from
93+
context: "One sentence explaining why this connection matters."
94+
```
95+
96+
The `context` sub-field is non-optional in Luhmann practice.
97+
98+
### R8 — context/ directory structure: one dir per primitive kind
99+
The current scheme (`context/workitems/`, `context/discussions/`,
100+
`context/notes/`, etc.) is correct. Each top-level directory maps
101+
1:1 to a primitive `kind:`, making it machine-readable without
102+
convention lookup. The indexer eliminates the need for
103+
subtype-based subdirectories within a kind. This is the "class /
104+
object" pattern: top level = kind, files within = instances.
105+
106+
### R9 — Discussion is a legitimate separate primitive
107+
Discussion models structured deliberation (question → exploration →
108+
DecisionRecord). It is not a WorkItem (not a unit of work), not a
109+
Note (multi-party, structured, produces outcomes), not an Artifact
110+
(no deliverable). The epistemic arc is: Note → Discussion →
111+
DecisionRecord → WorkItem.
112+
113+
### R10 — context/owner/, context/actors/, context/roles/ need
114+
documenting
115+
These directories are defined in schemas but absent from the
116+
AGENTS.md layout table. They should be added.
117+
118+
### R11 — MCP config paths are stale after skills reorganization
119+
The `.mcp.json` at project root still references
120+
`context/skills/<name>/mcp/server.py` (pre-reorganization paths).
121+
After the `e86ad06` reorganization commit, the correct paths are
122+
`context/skills/processkit/<name>/mcp/server.py` (and category
123+
subdirs for non-processkit skills). The config must be regenerated.

context/logs/LOG-loyal-vale.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
apiVersion: processkit.projectious.work/v1
3+
kind: LogEntry
4+
metadata:
5+
id: LOG-loyal-vale
6+
created: '2026-04-10T22:47:49+00:00'
7+
spec:
8+
event_type: discussion.opened
9+
timestamp: '2026-04-10T22:47:49+00:00'
10+
summary: 'Opened Discussion ''DISC-bold-plum'': ''How should context/ directory
11+
structure, primitive taxonomy (Artifact vs Note), Zettelkasten linking, and AGENTS.md
12+
scope be clarified and improved in processkit?'''
13+
subject: DISC-bold-plum
14+
subject_kind: Discussion
15+
---

0 commit comments

Comments
 (0)