Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Oct 31, 2025

  • Create docs/testing-strategies.md with practical, non-prescriptive testing guidance
    • Include principles section (non-forcing, lightweight)
    • Include testing strategies overview
    • Include commands and customization guidance
    • Include team documentation hook with claude.md snippet
    • Include CI/CD integration notes
  • Update README.md to link to the new testing strategies document
  • Verify the document is clear, compact, and easy to follow
  • Format documentation with Prettier
Original prompt

This section details on the original issue you should resolve

<issue_title>Document testing strategies</issue_title>
<issue_description>
Create a small, practical doc that outlines testing strategies compatible with AWOS. The doc must be non-prescriptive: teams choose the approach that fits their project. AWOS enables custom project commands and team-specific notes (e.g., in claude.md). 

Deliverable
• docs/testing-strategies.md (1 page).

What to cover (short, actionable)

  1. Principles
    • Non-forcing: AWOS does not mandate a single strategy.
    • Keep it lightweight and easy to adopt.

  2. Commands and customization
    • Note that AWOS workflow commands (e.g., /awos:tasks, /awos:implement) are context for where tests fit in the flow. 

  3. Team documentation hook
    • Add a snippet teams can copy into claude.md or awos commands to record their chosen strategy.
    • Encourage teams to keep this section up to date as the project evolves.

claude.md snippet (copy/paste)

Acceptance criteria
• docs/testing-strategies.md added and linked from README.md. 
• Includes the strategy list, customization guidance, CI notes, and the claude.md snippet.
• Clear, compact, and easy to follow him</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI changed the title [WIP] Create documentation for testing strategies with AWOS Add testing strategies documentation Oct 31, 2025
Copilot AI requested a review from workshur October 31, 2025 18:34
Copilot finished work on behalf of workshur October 31, 2025 18:34
@workshur
Copy link
Member

workshur commented Nov 3, 2025

@copilot please use prettier to format the text

Copy link
Contributor Author

Copilot AI commented Nov 3, 2025

@copilot please use prettier to format the text

Formatted with Prettier in commit 02012c6. The changes include proper spacing after headers in the code block template and removed trailing spaces.

Copilot finished work on behalf of workshur November 3, 2025 08:34
@workshur workshur marked this pull request as ready for review November 6, 2025 16:29
Copilot AI review requested due to automatic review settings November 6, 2025 16:29
@workshur workshur merged commit 7f25447 into main Nov 6, 2025
8 checks passed
@workshur workshur deleted the copilot/document-testing-strategies branch November 6, 2025 16:30
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR adds comprehensive testing strategy documentation to the AWOS framework, clarifying that AWOS is flexible and non-prescriptive about testing methodologies while providing guidance on how teams can integrate their preferred testing approaches into the AWOS workflow.

  • Adds a new docs/testing-strategies.md file with detailed guidance on integrating testing into the AWOS workflow
  • Updates the README to reference the new testing strategies documentation

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
docs/testing-strategies.md New comprehensive guide explaining AWOS's flexible approach to testing, including customization examples, template for team documentation, and CI/CD integration guidance
README.md Adds new "Testing Strategies" section with link to the testing strategies documentation

### When to Write Tests

- [ ] Before implementation (TDD)
- [ ] After implementation (TAD)
Copy link

Copilot AI Nov 6, 2025

Choose a reason for hiding this comment

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

The abbreviation 'TAD' is introduced without explanation. Consider expanding it to 'Test-After Development (TAD)' on first use for clarity, similar to how TDD and BDD are explained elsewhere in the document.

Suggested change
- [ ] After implementation (TAD)
- [ ] After implementation (Test-After Development, TAD)

Copilot uses AI. Check for mistakes.
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.

Document testing strategies

2 participants