Skip to content

docs: add automated QA skill guide#942

Merged
factory-nizar merged 3 commits intomainfrom
docs/automated-qa-guide
Apr 13, 2026
Merged

docs: add automated QA skill guide#942
factory-nizar merged 3 commits intomainfrom
docs/automated-qa-guide

Conversation

@factory-nizar
Copy link
Copy Markdown
Contributor

@factory-nizar factory-nizar commented Apr 13, 2026

Summary

Adds a new guide documenting the /install-qa and qa skills -- how to set up automated end-to-end QA that tests your application as a real user would, with visual evidence, CI integration, and failure learning.

Where this page appears

  • Docs > Features -- listed after Code Review in the main nav sidebar
  • Guides > Skills -- added as the 9th skill in the cookbook (both EN and JP nav)
  • Skills overview page (cli/configuration/skills) -- added to the numbered list and card grid

Files changed

  • docs/guides/skills/automated-qa.mdx -- new guide (EN)
  • docs/jp/guides/skills/automated-qa.mdx -- Japanese placeholder with summary
  • docs/docs.json -- nav entries in Features group and Skills group (EN + JP)
  • docs/cli/configuration/skills.mdx -- added to cookbook list and card grid

Content highlights

  • Why automated QA matters
  • Quick start with /install-qa
  • What gets generated (orchestrator, sub-skills, config.yaml, workflow)
  • Testing tools: agent-browser (web), tuistory (CLI/TUI), curl (API)
  • CI integration with GitHub Actions
  • Failure learning strategies
  • Two real-world examples with actual QA reports:
image image image image image image

closes FAC-18363

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@factory-droid
Copy link
Copy Markdown
Contributor

factory-droid bot commented Apr 13, 2026

Droid finished @factory-nizar's task —— View job


Comment thread docs/docs.json
Copy link
Copy Markdown
Contributor

@factory-droid factory-droid bot left a comment

Choose a reason for hiding this comment

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

The new Automated QA guide looks solid and is correctly wired into EN nav. One concrete follow-up: the JP Docs sidebar “機能” (Features) group is missing the Automated QA entry even though the JP page exists, so JP users won’t find it from the Features section.

factory-nizar and others added 2 commits April 13, 2026 14:54
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@factory-nizar factory-nizar merged commit 3bccec1 into main Apr 13, 2026
2 checks passed
@factory-nizar factory-nizar deleted the docs/automated-qa-guide branch April 13, 2026 22:43
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.

2 participants