Repository navigation
docs: collaboration setup — issue templates, CONTRIBUTING, AGENTS, review labels, create-issue skill - #35
Draft
regislon wants to merge 1 commit into
Draft
docs: collaboration setup — issue templates, CONTRIBUTING, AGENTS, review labels, create-issue skill#35regislon wants to merge 1 commit into
regislon wants to merge 1 commit into
Conversation
…view labels, create-issue skill Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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
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.
Problem
The repo has no shared way of working yet: issues are free-form, there is no contribution guide, no rules for the AI agents that prepare many PRs, and nothing in the repo describes how
mainshould be protected.Change
.github/ISSUE_TEMPLATE/): Feature / improvement and Bug report, each with a single required Done when field (Must have / Nice to have) and closing tips; blank issues disabled. They use the existingenhancementandbuglabels.main, Conventional Commits titles (as the history already uses), PR description content, CI as the check gate, two-stage review.llm-changes-neededorready-for-human-review;needs-rebaseis set and cleared by.github/workflows/needs-rebase-label.yml.mainruleset (.github/rulesets/main.json), to import by hand: 1 approval, review threads resolved,lint-and-type+testpassing on an up-to-date branch, no force-push/deletion, linear history.create-issueagent skill (.agents/skills/create-issue/): tool-agnostic Agent Skills format, linked into.claude/skills/for Claude Code and referenced from AGENTS.md for other tools. A script reads the issue forms at runtime and renders a body identical to a browser submission; the skill searches for duplicates, has the user confirm Done when, and only creates the issue on a clear yes..gitignorekeeps.claude/skills/tracked (the rest of.claude/stays ignored);mdformat-frontmatteradded to pre-commit so skill frontmatter survives formatting.This was first set up and reviewed on our fork (AdAstraEco/cornerstone_luc#50) and is ported here unchanged except for the issue-template link.
Done when
Must have
main(on merge)llm-changes-needed,ready-for-human-reviewandneeds-rebase(the needs-rebase workflow fails to label untilneeds-rebaseexists).github/rulesets/main.json(Settings → Rules → Rulesets → Import a ruleset)Nice to have
create-issueagent skillTesting
pre-commitpasses on all changed files;uv run pytestpasses (1895 passed); the ruleset JSON and issue-form YAML parse.create-issuerender script tested on the fork: full render, missing required fields, unknown field, unknown template. Claude Code discovers the skill through the symlink; Codex / Gemini / Cursor discovery of.agents/skills/not tested. No real issue was created.main, so the chooser can be checked under New issue after merge; the needs-rebase workflow also only runs once onmain.Impact on outputs
None.
Dependencies
None. Open questions for the team:
Prepared with Claude Code (Claude Opus 5.5).
🤖 Generated with Claude Code