Skip to content

docs: tighten agent and pull request guidance - #176

Merged
Azganoth merged 4 commits into
mainfrom
docs/standardize-contribution-guidance
Aug 4, 2026
Merged

docs: tighten agent and pull request guidance#176
Azganoth merged 4 commits into
mainfrom
docs/standardize-contribution-guidance

Conversation

@Azganoth

@Azganoth Azganoth commented Aug 4, 2026

Copy link
Copy Markdown
Owner

Summary

Clarify repository guidance where recent agent work exposed ambiguity:

  • Route workflow, documentation, pull request, project-management, and release work directly to their authoritative sections.
  • Reserve code comments for non-obvious rationale, constraints, and consequences instead of narrating implementation.
  • Allow accepted behavior changes to update or replace stale tests, fixtures, snapshots, and specifications while keeping enforcement guardrails explicit.
  • Prefer equivalent Tailwind utilities through @apply in CSS files, with clear exceptions for behavior Tailwind cannot express precisely.
  • Standardize pull request verification around focused behavioral evidence, manual scenarios, and relevant omissions without reproducing CI output.

Related Issue

Not applicable. Focused repository-guidance update based on recurring contribution and agent-work patterns.

Verification

pnpm exec oxfmt --check AGENTS.md src/AGENTS.md .github/pull_request_template.md and git diff --check.

Confirmed that every newly linked documentation path and section heading resolves.

Documentation-only; no executable configuration or application behavior changed.

@Azganoth Azganoth self-assigned this Aug 4, 2026
@Azganoth Azganoth added the Documentation Improvements or additions to documentation label Aug 4, 2026
@Azganoth
Azganoth marked this pull request as ready for review August 4, 2026 03:45
@Azganoth
Azganoth enabled auto-merge (squash) August 4, 2026 03:45
@Azganoth
Azganoth merged commit d7b8034 into main Aug 4, 2026
2 checks passed
@Azganoth
Azganoth deleted the docs/standardize-contribution-guidance branch August 4, 2026 03:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant