Skip to content

Make the agent guidance findable, and document add and the library - #48

Merged
elemdos merged 1 commit into
masterfrom
fix/agent-guidance-discovery
Sep 30, 2026
Merged

elemdos merged 1 commit into
masterfrom
fix/agent-guidance-discovery

Conversation

@elemdos

@elemdos elemdos commented Sep 30, 2026

Copy link
Copy Markdown
Contributor

From the second round of agent-driven release testing, run on a stack that already includes #47:

  • Guidance not found. An agent working without MCP never read the workspace AGENTS.md (and so hit fields: vs subfields:): Claude Code loads CLAUDE.md automatically, not AGENTS.md. Also, primo init didn't write either file. Now init, new and pull write AGENTS.md plus a CLAUDE.md containing @AGENTS.md. Neither overwrites an existing file.
  • primo add with dev running. An agent took the MCP instructions to mean add works live. AGENTS.md now says to stop primo dev first and restart it afterwards, and notes that copied folders get fresh ids. The MCP instructions are fixed in a companion PR.
  • library/ undocumented. Adds a Shared library section. I checked the layout (library/groups.yaml + library/<group-folder>/<block>/) by running primo dev and confirming the block appears in the CMS library.
  • primo preview from the workspace root now names the sites to pass as --dir (it already exited 1).

Tests

  • New test: init writes both files and a user-edited CLAUDE.md is left alone.
  • 93 tests: 92 pass, and the one skip needs a real binary.
  • Checked by hand: init output, the preview hint, and library loading.

🤖 Generated with Claude Code

Round-2 release test agents still missed the workspace AGENTS.md (Claude Code
loads CLAUDE.md, not AGENTS.md, and init didn't write it), believed primo add
works with dev running, and found no docs for library/.

- init, new, and pull write AGENTS.md plus a CLAUDE.md that imports it
- AGENTS.md: primo add needs dev stopped (and re-ids copied folders); a
  Shared library section with the verified library/ layout
- primo preview from the workspace root names the sites to pass as --dir

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Sep 30, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 24 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 3e1a0c4d-da67-4f97-ac6b-97824bd51f48

📥 Commits

Reviewing files that changed from the base of the PR and between 0798ce1 and 14a486d.

📒 Files selected for processing (5)
  • src/commands/init.ts
  • src/commands/new.ts
  • src/commands/preview.ts
  • src/commands/pull.ts
  • tests/site-ids.test.mjs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@elemdos
elemdos merged commit b6d4f1f into master Sep 30, 2026
2 checks passed
@elemdos elemdos mentioned this pull request Sep 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant