Skip to content

docs: strengthen agent-instruction guardrails (session-start gate, change-scope rules, thin AGENTS/CLAUDE pointers) - #22

Merged
ernysans merged 1 commit into
mainfrom
ernysans-improve-agent-instructions
Sep 17, 2026
Merged

ernysans merged 1 commit into
mainfrom
ernysans-improve-agent-instructions

Conversation

@ernysans

Copy link
Copy Markdown
Member

Summary

Documentation-only improvement pass on this repo's agent-instruction files, bringing them up to a guardrail bar established across sibling repos. No application/library code or build output (lib/) changed.

Changes

  • Session Start Identity Gate (.github/copilot-instructions.md §0) — new: at the start of every workflow, before acting, ask whether the requester is the project owner and whether they have permission for destructive changes; non-owners are restricted to small, narrowly-scoped fixes and directed to open a Task/Issue for larger work; only a top-tier agent may work with a non-owner.
  • Change Scope Guardrails (§0.1) and Deployment out-of-scope note (§0.2) — surgical-changes-only policy, explicit reminder that a src/ change isn't complete until npm run build output is regenerated and committed together (per this repo's existing CI drift check), and a plain statement that this repo has no publish/deploy automation (verified against .github/workflows/nodejs.yml).
  • De-named all specific AI model references across instruction files in favor of tier-neutral wording (routing/escalation policy preserved); removed human-effort/hour estimate tracking.
  • Added root AGENTS.md and CLAUDE.md as thin pointers to the canonical .github/copilot-instructions.md and .github/instructions/*.md files (no restated rule text, so nothing can drift out of sync).
  • One-line cross-reference pointer added in .github/instructions/cross-repo.instructions.md §6.

Verification

  • gh api repos/furcata/core-node --jq '.visibility' → public (confirms nothing furcata-internal may be referenced).
  • Repo-wide grep for named models / human-hour estimates / private furcata repo references → zero hits.
  • src/ and lib/ untouched — no rebuild required, build parity intact.

…hin AGENTS/CLAUDE pointers

- Add Session Start Identity Gate (.github/copilot-instructions.md §0)
- Add Change Scope Guardrails and deployment-out-of-scope note (§0.1, §0.2)
- Replace named AI model references with tier-neutral wording; remove
  human-effort/hour estimates from instruction files
- Add root AGENTS.md and CLAUDE.md as thin pointers to the canonical
  .github/copilot-instructions.md and .github/instructions/ files
- Add cross-reference pointer in cross-repo.instructions.md
@ernysans
ernysans merged commit 98690cc into main Sep 17, 2026
2 checks passed
@ernysans
ernysans deleted the ernysans-improve-agent-instructions branch September 17, 2026 22:51
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