Repository navigation
docs(conventions): rules encode intent; trim, update and add releases and generation - #40
Merged
Merged
Conversation
… and generation The general conventions open with how to read them: follow the intent, not the letter; nothing is maintained for its own sake; generate over hand-maintain. Testing asks for the critical paths and tests that each catch a regression, not a coverage percentage. The gate is tool-agnostic instead of `make` targets, the per-archetype table no longer names repos or hypothesis, retries allow a bounded reconnect, and the branch-and-PR flow with squash merges is the default. Releases are tags with notes drafted from commits and curated on GitHub; there is no changelog file. Docs state what the code does not and never carry drifting counts. AGENTS.md needs no CLAUDE.md symlink now that Claude Code reads it; this repo's own symlink goes too. Python and TypeScript modules add the no-escape-hatch and docstring-semantics rules. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019ydLojugUs3zcsJbN9axQF
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Applies the prepared conventions rewrite.
conventions/general.mdopens with "How to read these": follow the intent of a rule, nothing is maintained for its own sake, generate over hand-maintain. Testing asks for critical paths and tests that each catch a regression, with no coverage target. The quality gate is described tool-agnostically. The archetype list names no repositories or hypothesis. A bounded reconnect is allowed, blind retry loops are not. Branch, PR and squash merge is the default flow. Releases are tags with notes drafted from conventional commits and curated on GitHub Releases; there is no changelog file. Docs state what the code does not say. AGENTS.md is the agent instruction file with no CLAUDE.md symlink.conventions/python.md:Anyonly at boundaries; docstrings explain semantics with Google-style sections.conventions/typescript.md: noanyescape hatch; same docstring rule.CONVENTIONS.mdregenerated withscripts/assemble-conventions.sh.CLAUDE.mdsymlink is removed.Prettier passes on the tree.
🤖 Generated with Claude Code
https://claude.ai/code/session_01U2LtVuEjWWeYigS7mwFL5L
Generated by Claude Code