Skip to content

Add draft-first PR creation, test naming, and Specs suffix conventions - #438

Merged
dennisdoomen merged 1 commit into
Fallout-build:mainfrom
dennisdoomen:docs-skill-agents-guidance
Jun 29, 2026
Merged

Add draft-first PR creation, test naming, and Specs suffix conventions#438
dennisdoomen merged 1 commit into
Fallout-build:mainfrom
dennisdoomen:docs-skill-agents-guidance

Conversation

@dennisdoomen

@dennisdoomendennisdoomen commented Jun 28, 2026

Copy link
Copy Markdown
Collaborator

Add three focused documentation rules to guide agent and human contributors on testing and PR creation practices.

What changed

  • docs/agents/issue-and-pr-style.md: Added draft-by-default rule (PRs created as draft unless explicitly requested otherwise)
  • docs/agents/conventions.md: Added AV1600 test naming convention (behavior-focused, present-tense test names) and Specs suffix convention (test projects/files/classes use Specs suffix instead of Test/Tests)

Why

These rules belong in domain-specific docs where they apply. Draft creation is part of PR best practices (issue-and-pr-style), and test naming conventions are code style (conventions). Using Specs clarifies behavior-specification semantics in testing.

@dennisdoomendennisdoomen added the target/vCurrent Targets the current version label Jun 28, 2026
@dennisdoomendennisdoomen changed the title Add skills/agents.md with feedback-driven agent rulesUpdate AGENTS.md with feedback-driven agent rulesJun 28, 2026
@dennisdoomendennisdoomen changed the title Update AGENTS.md with feedback-driven agent rulesAdd draft-first and behavior-focused test naming guidanceJun 28, 2026
dennisdoomen added a commit to dennisdoomen/Fallout that referenced this pull request Jun 28, 2026
- Add draft-by-default rule to issue-and-pr-style.md (part of PR creation best practices)
- Add AV1600 test naming convention to conventions.md (code style)
- Revert AGENTS.md to remove overly broad rules; keep canonical brief
ClosesFallout-build#438
dennisdoomen added a commit to dennisdoomen/Fallout that referenced this pull request Jun 28, 2026
- Create PRs as draft by default (issue-and-pr-style.md)
- Test naming follows AV1600 behavior-focused style (conventions.md)
- Test files/classes use Specs suffix (conventions.md)
- Revert AGENTS.md to remove overly broad rules; keep canonical brief
ClosesFallout-build#438
@dennisdoomen
dennisdoomenforce-pushed the docs-skill-agents-guidance branch from f893ab9 to 87b29b2CompareJune 28, 2026 12:07
dennisdoomen added a commit to dennisdoomen/Fallout that referenced this pull request Jun 28, 2026
- Create PRs as draft by default (issue-and-pr-style.md)
- Test naming follows AV1600 behavior-focused style (conventions.md)
- Test files/classes use Specs suffix (conventions.md)
- Revert AGENTS.md to remove overly broad rules; keep canonical brief
ClosesFallout-build#438
@dennisdoomen
dennisdoomenforce-pushed the docs-skill-agents-guidance branch from 87b29b2 to dc1fd56CompareJune 28, 2026 12:08
@dennisdoomendennisdoomen changed the title Add draft-first and behavior-focused test naming guidanceAdd draft-first PR creation, test naming, and Specs suffix conventionsJun 28, 2026
@dennisdoomen
dennisdoomen marked this pull request as ready for review June 28, 2026 12:11

@ChrisonSimtianChrisonSimtian left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

lgtm, I like the draft addition for PRs. really should raise PRs as drafts and then get HITL in first before marking it as reviewable (hence the label that we can now get rid of :-) )

@ChrisonSimtianChrisonSimtian added the Can Merge These PRs are just waiting to be merged, nothing more to do and maintainer has approved label Jun 28, 2026
- Create PRs as draft by default (issue-and-pr-style.md)
- Test naming follows AV1600 behavior-focused style (conventions.md)
- Test files/classes use Specs suffix (conventions.md)
- Revert AGENTS.md to remove overly broad rules; keep canonical brief
ClosesFallout-build#438
@dennisdoomen
dennisdoomenforce-pushed the docs-skill-agents-guidance branch from dc1fd56 to fe15af9CompareJune 29, 2026 04:38
@dennisdoomen
dennisdoomen enabled auto-merge (rebase) June 29, 2026 04:38
@dennisdoomen
dennisdoomen merged commit 902fa3b into Fallout-build:mainJun 29, 2026
1 check passed
@ChrisonSimtianChrisonSimtian added the enhancement New feature or request label Jul 11, 2026
@dennisdoomendennisdoomen added documentation Improvements or additions to documentation skip-changelog Dont add to the Github Release Notes and removed enhancement New feature or request labels Jul 20, 2026
@dennisdoomen
dennisdoomen deleted the docs-skill-agents-guidance branch August 23, 2026 18:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Can MergeThese PRs are just waiting to be merged, nothing more to do and maintainer has approveddocumentationImprovements or additions to documentationskip-changelogDont add to the Github Release Notestarget/vCurrentTargets the current version

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@dennisdoomen@ChrisonSimtian