main · last commit
18 hours ago ·
8tmadfpi
spec-xwi Fill in specs' CLAUDE.md stub with the family-wide conventions from tokens'
Lined Up
bd update spec-xwi --claim
bd close spec-xwi
| Created by | Eugene Blikh |
| Owner | bigbes@gmail.com |
| Created | 2026-08-17T20:40:13Z |
| Updated | 2026-08-17T20:40:13Z |
What is wrong: specs' `CLAUDE.md` is a 77-line unedited stub, still containing the placeholder strings `_Add your build and test commands here_` and `_Add your project-specific conventions here_`. Why it matters: `sourcehut-tokens/CLAUDE.md` (107 lines, zero placeholders) carries several rules that are family-wide, not tokens-specific: the layering rule, the `make test`/`make test-pg` warning, the `make css` embedding warning, the doc-comment density rule, and "never default to the widest answer". Without these, an agent or contributor working in specs has no local record of conventions that several of the other findings in this audit (the sha256sum Makefile bug, the missing check-version gate, the CI DB-test skip) are instances of re-introducing. Sibling that does it correctly: `sourcehut-tokens/CLAUDE.md`. Fix: promote the four generalisable sections of `sourcehut-tokens/CLAUDE.md` into specs' `CLAUDE.md`, adjusting the env-var name (`SPEC_TEST_PG` or whatever specs' equivalent is) and the layering diagram for specs' own package names. Note: confidence verified — counted lines and placeholder strings directly in specs' `CLAUDE.md`. Audit: D44 (cross-repo audit, 2026-08-17)
No outgoing dependencies.
Nothing depends on this issue.
| id | spec-xwi |
| content_hash | 30d999aae761a098a4e52c0d94d1708a8bf288d90172f956d1f270ccb3770c69 |
| title | Fill in specs' CLAUDE.md stub with the family-wide conventions from tokens' |
| description | What is wrong: specs' `CLAUDE.md` is a 77-line unedited stub, still containing the placeholder strings `_Add your build and test commands here_` and `_Add your project-specific conventions here_`. Why it matters: `sourcehut-tokens/CLAUDE.md` (107 lines, zero placeholders) carries several rules that are family-wide, not tokens-specific: the layering rule, the `make test`/`make test-pg` warning, the `make css` embedding warning, the doc-comment density rule, and "never default to the widest answer". Without these, an agent or contributor working in specs has no local record of conventions that several of the other findings in this audit (the sha256sum Makefile bug, the missing check-version gate, the CI DB-test skip) are instances of re-introducing. Sibling that does it correctly: `sourcehut-tokens/CLAUDE.md`. Fix: promote the four generalisable sections of `sourcehut-tokens/CLAUDE.md` into specs' `CLAUDE.md`, adjusting the env-var name (`SPEC_TEST_PG` or whatever specs' equivalent is) and the layering diagram for specs' own package names. Note: confidence verified — counted lines and placeholder strings directly in specs' `CLAUDE.md`. Audit: D44 (cross-repo audit, 2026-08-17) |
| design | |
| acceptance_criteria | |
| notes | |
| status | open |
| priority | 3 |
| issue_type | task |
| assignee | NULL |
| estimated_minutes | NULL |
| created_at | 2026-08-17T20:40:13Z |
| created_by | Eugene Blikh |
| owner | bigbes@gmail.com |
| updated_at | 2026-08-17T20:40:13Z |
| closed_at | NULL |
| closed_by_session | |
| external_ref | NULL |
| spec_id | |
| compaction_level | 0 |
| compacted_at | NULL |
| compacted_at_commit | NULL |
| original_size | NULL |
| sender | |
| ephemeral | 0 |
| wisp_type | |
| pinned | 0 |
| is_template | 0 |
| mol_type | |
| work_type | |
| source_system | |
| metadata | �{} |
| source_repo | |
| close_reason | |
| event_kind | |
| actor | |
| target | |
| payload | |
| await_type | |
| await_id | |
| timeout_ns | 0 |
| waiters | |
| hook_bead | |
| role_bead | |
| agent_state | |
| last_activity | NULL |
| role_type | |
| rig | |
| due_at | NULL |
| defer_until | NULL |
| no_history | 0 |
| started_at | NULL |
| is_blocked | 0 |
| id | 01a01174-0d42-78e5-bc28-e019f2801bb7 |
| issue_id | spec-xwi |
| event_type | created |
| actor | Eugene Blikh |
| old_value | |
| new_value | |
| comment | NULL |
| created_at | 2026-08-17T23:40:13Z |
No comments.