Skip to content

Add Technical Writer and Compliance Auditor agents#56

Merged
msitarzewski merged 3 commits intomsitarzewski:mainfrom
jnMetaCode:feat/add-technical-writer-compliance-auditor
Mar 10, 2026
Merged

Add Technical Writer and Compliance Auditor agents#56
msitarzewski merged 3 commits intomsitarzewski:mainfrom
jnMetaCode:feat/add-technical-writer-compliance-auditor

Conversation

@jnMetaCode
Copy link
Contributor

Summary

  • Adds Technical Writer agent (specialized/technical-writer.md) — covers API documentation, getting-started guides, architecture decision records, documentation review checklists, and docs-as-code workflows
  • Adds Compliance Auditor agent (specialized/compliance-auditor.md) — covers SOC 2, ISO 27001, HIPAA, PCI-DSS audit readiness, gap assessment, evidence collection, and continuous compliance

Closes #22.

Design decisions

  • Both agents placed in specialized/ since they serve cross-functional roles rather than belonging to a single department
  • Compliance Auditor focuses on technical/operational compliance (controls, evidence, audits), complementing the existing Legal Compliance Checker which covers legal/regulatory compliance
  • Both follow the established frontmatter + identity + mission + rules + deliverables + workflow structure

Checklist

  • YAML frontmatter with name, description, color
  • Passes scripts/lint-agents.sh with no errors
  • Includes actionable templates and deliverables
  • No overlap with existing agents

Test plan

  • Verified both files pass the lint script
  • Confirmed no naming conflicts with existing agents

Closes msitarzewski#22. Adds two new specialized agents:

- Technical Writer: API docs, getting-started guides, ADRs, doc review
- Compliance Auditor: SOC 2, ISO 27001, gap assessments, evidence collection
The GITHUB_OUTPUT format does not support multiline values with simple
echo. Use heredoc delimiter to pass multiple changed file paths correctly.
@msitarzewski
Copy link
Owner

Hey @jnMetaCode — thanks for this! The Compliance Auditor is a great addition and fills a real gap alongside the existing Legal Compliance Checker. The lint workflow fix is also appreciated.

One note: a later submission (PR #67) included a Technical Writer agent that ended up being a closer fit for the repo's style and depth, and has already been merged. Could you drop the Technical Writer from this PR and keep the Compliance Auditor + lint fix? Happy to merge once that's updated.

PR msitarzewski#67 already merged a better-fit engineering/engineering-technical-writer.md.
Keep only Compliance Auditor + lint workflow fix.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jnMetaCode
Copy link
Contributor Author

Thanks for the review! Makes total sense — engineering-technical-writer from #67 is a better fit.

Removed specialized/technical-writer.md. PR now contains only:

  • Compliance Auditor (specialized/compliance-auditor.md)
  • Lint workflow fix (multiline GITHUB_OUTPUT handling)

Ready for another look!

@msitarzewski msitarzewski merged commit 8f30207 into msitarzewski:main Mar 10, 2026
1 check passed
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