Developer Workflow and Architecture Skills
Review ADRs, build design patterns, automate PRs, and manage dependencies
What You Can Do
This collection of skills improves code quality, architecture documentation, and team workflow coordination. Review Architecture Decision Records with fresh perspective and rewrite them for clarity, implement type-safe AST visitor patterns for robust code organization, automate Biome linting upgrades across monorepos, and generate well-structured GitHub pull requests integrated with Linear project tracking. Perfect for teams that care about maintainable code, clear decision documentation, and smooth development workflows.
Features
Analyze Architecture Decision Records for narrative clarity, buried decisions, and reader context gaps. Identifies transient references and missing grounding examples, then rewrites documents for maximum comprehension by future readers.
Create type-safe discriminated unions with frozen classes and visitor dispatch for AST nodes and command hierarchies. Ensures compiler errors when new variants are added instead of silent omissions at multiple dispatch sites.
Automate Biome linter upgrades across monorepo workspaces. Updates configuration files to new schema versions, runs lint checks, and offers safe or unsafe fix strategies to handle regressions.
Generate GitHub pull requests with automatic Linear ticket detection from branch names and commit messages. Includes decision-led narrative descriptions structured for reader comprehension and proper title formatting.
Structure technical documentation around decisions rather than implementation details. Leads with conclusions and builds understanding through narrative progression from substrate to delivery.
Handle complex multi-file updates when managing dependencies or revising documentation. Ensures consistency across related configuration files and catches version mismatches.
Example Output
Review ADRs for clarity and narrative flow
review-adr docs/adr/0015-query-optimization.md
The skill analyzes your ADR to identify buried decisions, assumptions that lack explanation, and transient references that won't make sense to future readers. It then rewrites the document to lead with the decision, build reasoning progressively, and move rejected alternatives to the end.
Generate type-safe visitor pattern for AST nodes
generate-visitor-pattern QueryNode Bar Baz Qux
Creates a frozen-class visitor pattern with abstract base class, visitor interface, and concrete subclasses. Ensures that adding new variants becomes a compiler error at every dispatch site, eliminating silent omissions and runtime surprises.
Automate Biome package upgrades across workspaces
bump-biome @biomejs/biome@1.8.0
Upgrades Biome in all workspace packages, converts biome.json files to biome.jsonc format, updates all schema versions, and runs comprehensive lint checks. Reports any regressions and offers both safe and unsafe fix options.
What's Included
- ADR Review Skill: Analyzes and rewrites Architecture Decision Records for clarity and long-term team maintainability
- AST Visitor Pattern Skill: Generates type-safe visitor patterns for discriminated unions with frozen classes and compiler-checked dispatch
- Biome Bump Skill: Automates Biome linter upgrades, configuration file migration, and lint verification across monorepos
- Create PR Skill: Generates GitHub PRs with Linear ticket integration, decision-led descriptions, and proper formatting conventions
Who It's For
- Backend Engineers
- Systems Architects
- Engineering Leads
- Open Source Maintainers
Best For
- Technical documentation and ADRs
- Code architecture and design patterns
- Dependency and version management
- Pull request and code review workflows