chore(agents): add agent rules, site guides and Actions deploy [BOT] - #11
Merged
Merged
Conversation
Keeps the per-clone identity, the local agent configuration, scratch space, Finder metadata and the Pages staging directory out of the repository.
AGENTS.md carries the core rules for any coding agent and tells it to read whichever other agents' instruction files are present. The hooks check the commit message format and reject added lines that name a local path. .gitidentity.example is the template for the per-clone commit identity.
Generated from the site as it stands. Lines marked (unverified) and sections marked to fill in still need confirming by hand.
Deploying from the branch publishes every file in it, including AGENTS.md and docs/. The workflow stages the site without what .pagesignore lists and fails if a doc asset from the README's table would be published anyway. The README records that the Pages source still has to be switched to GitHub Actions, and how.
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
The design guide incorrectly reports several Flexbox Grid classes as unstyled.
Review effort: Balanced
Findings: 1
Open (1)
What changed in this PR
Adds agent guidance and a filtered GitHub Actions deployment so internal repository files are not published.
Changes:
- Adds agent rules, editing guides, Git hooks, and identity configuration.
- Adds Pages staging exclusions and deployment workflow.
- Documents local preview and deployment migration.
| File | Description |
|---|---|
README.md |
Documents preview, deployment, and assets. |
AGENTS.md |
Defines coding-agent rules. |
docs/voice.md |
Adds copy guidance. |
docs/design.md |
Adds design guidance. |
docs/adding-content.md |
Adds content-authoring guidance. |
.pagesignore |
Excludes internal files from Pages. |
.gitignore |
Ignores local and generated files. |
.gitidentity.example |
Provides identity configuration template. |
.github/workflows/pages.yml |
Deploys the staged Pages artifact. |
.github/pages-stage.sh |
Builds and validates the deployment directory. |
.githooks/pre-commit |
Detects machine-local paths. |
.githooks/commit-msg |
Validates commit messages. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
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.
Why
Deploying from the branch publishes every file in it, so agent rules and
internal guides would go live at armada-dn.eu. This adds shared rules for
coding agents and guides for editing the site, and moves the deploy to GitHub
Actions so that only the site itself is published.
Changes
.gitignorefor the per-clone identity, local agent config, scratch space and Pages staging.AGENTS.md, thecommit-msgandpre-commithooks, and.gitidentity.example.docs/, generated from the site and partly still to fill in..pagesignorelists, and document the switch in the README.Verified
validate-commit-msg.shon all four commit messages: OK. All four are signed..github/pages-stage.shrun locally: exit 0,_site/holds the pages and assets.docrow in the README asset table is matched in.pagesignore: 8 of 8.PR text drafted by Claude Code (claude-opus-5-5[1m]), reviewed by the author.