main · last commit
17 hours ago ·
skqvdbd8
sr-ht-compare-a7j Give sourcehut-compare a CLAUDE.md with the family's generalisable rules
Lined Up
bd update sr-ht-compare-a7j --claim
bd close sr-ht-compare-a7j
| Created by | bigbes |
| Owner | bigbes@gmail.com |
| Created | 2026-08-17T21:38:40Z |
| Updated | 2026-08-17T21:38:40Z |
What is wrong: sourcehut-compare has neither a CLAUDE.md nor an AGENTS.md — the only one of the nine custom services with no such file at all. (Companion finding, filed in other trackers: eight sibling repos — artifacts, bench, coverage, curator, dolt, federation, specs, sr-ht-ecore — do have a CLAUDE.md, but it's a 77-line unedited stub full of placeholders like '_Add your build and test commands here_'.) Why it matters: sourcehut-tokens/CLAUDE.md (107 lines, no placeholders) already 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 the 'never default to the widest answer' rule. An agent working in compare currently gets none of this context, which is exactly how defects like the sha256sum portability bug (D08) or the missing check-version gate (D12) get reintroduced by an agent that has no repo-local guidance to consult. Correct variant: repo/path sourcehut-tokens/CLAUDE.md. Fix: promote the four generalisable sections of sourcehut-tokens/CLAUDE.md into a new sourcehut-compare/CLAUDE.md, adjusting the env-var names and the layering diagram for compare's own package layout (web/, frontend/, authz/). Audit: D44 (cross-repo audit, 2026-08-17)
No outgoing dependencies.
Nothing depends on this issue.
| id | sr-ht-compare-a7j |
| content_hash | 3ba8539d07fbd946f64aed45dd6ab47a1cd460a94806d9a39bed3f65b2f905c0 |
| title | Give sourcehut-compare a CLAUDE.md with the family's generalisable rules |
| description | What is wrong: sourcehut-compare has neither a CLAUDE.md nor an AGENTS.md — the only one of the nine custom services with no such file at all. (Companion finding, filed in other trackers: eight sibling repos — artifacts, bench, coverage, curator, dolt, federation, specs, sr-ht-ecore — do have a CLAUDE.md, but it's a 77-line unedited stub full of placeholders like '_Add your build and test commands here_'.) Why it matters: sourcehut-tokens/CLAUDE.md (107 lines, no placeholders) already 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 the 'never default to the widest answer' rule. An agent working in compare currently gets none of this context, which is exactly how defects like the sha256sum portability bug (D08) or the missing check-version gate (D12) get reintroduced by an agent that has no repo-local guidance to consult. Correct variant: repo/path sourcehut-tokens/CLAUDE.md. Fix: promote the four generalisable sections of sourcehut-tokens/CLAUDE.md into a new sourcehut-compare/CLAUDE.md, adjusting the env-var names and the layering diagram for compare's own package layout (web/, frontend/, authz/). Audit: D44 (cross-repo audit, 2026-08-17) |
| design | |
| acceptance_criteria | |
| notes | |
| status | open |
| priority | 3 |
| issue_type | chore |
| assignee | NULL |
| estimated_minutes | NULL |
| created_at | 2026-08-17T21:38:40Z |
| created_by | bigbes |
| owner | bigbes@gmail.com |
| updated_at | 2026-08-17T21:38:40Z |
| 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 | 01a011a9-90b2-7134-b0e4-b6751e3f6ede |
| issue_id | sr-ht-compare-a7j |
| event_type | created |
| actor | bigbes |
| old_value | |
| new_value | |
| comment | NULL |
| created_at | 2026-08-18T00:38:40Z |
No comments.