Skip to content

Adopting a repo: one AGENTS.md; release 0.2.3 #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Marius1311 wants to merge 1 commit into from
Closed

Adopting a repo: one AGENTS.md; release 0.2.3 #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "analysis-workflow",
"version": "0.2.2",
"version": "0.2.3",
"description": "Conventions for analysis repos where humans (notebooks) and coding agents (scripts) work side by side: one task per session, worktree and directory; worktree-safe output paths; additive write-back to AnnData zarr working objects. Ships a skill, guard hooks and the analysis_workflow Python package.",
"author": {
"name": "quadbio"
Expand Down
4 changes: 3 additions & 1 deletion skills/analysis-workflow/references/repos.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,5 +33,7 @@ their other repos). Then:
match inside every task directory, and their re-includes keep READMEs, placeholders and task evidence tracked.
4. Remove any notebook-output stripping (`nbstripout` in `.gitattributes`, its install step, its CI check).
5. Copy `assets/REVIEW_GUIDE.md`, adding the repo's own rules under its last heading.
6. In `AGENTS.md`, one short section naming the plugin and where the working objects live; delete restated rules.
6. The repo's instructions live in one `AGENTS.md`: rename a `CLAUDE.md` to it, or merge one in, since Claude Code
reads `AGENTS.md` only when there is no `CLAUDE.md`. In it, one short section naming the plugin and where the
Comment on lines +36 to +37

@chatgpt-codex-connector chatgpt-codex-connector Bot Oct 14, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep instructions loadable in every supported Claude session

When an adopter uses Claude Code before v2.1.277, has a CLAUDE.local.md, or launches beneath another project-level CLAUDE.md, replacing the repository's CLAUDE.md with only AGENTS.md silently leaves the new dataset and working-object instructions unloaded. Claude's instruction-loading documentation identifies these version and file-presence limitations, but this plugin declares no minimum Claude version and the checklist does not ask adopters to audit the other blockers; retain an @AGENTS.md loader or explicitly cover/version-gate these cases.

Useful? React with 👍 / 👎.

@Marius1311 Marius1311 Oct 14, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed that the import must stay. Rather than fix the step, I am closing this PR: the instruction-file layout (AGENTS.md plus a CLAUDE.md importing it) belongs to analysis_template and the marketplace conventions (quadbio/claude-plugins#14), so this checklist should not restate it. Step 6 stays as on main.

working objects live; delete restated rules.
7. Optionally `uvx cruft link https://github.com/quadbio/analysis_template` to receive template updates.
Loading