flowmade-one/architecture
3
0
Fork 0
Code Issues 20 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Create software-architecture skill #56

New Issue
Closed
opened 2026-01-09 22:58:51 +00:00 by HugoNijhuis · 0 comments
HugoNijhuis commented 2026-01-09 22:58:51 +00:00
Owner
Copy Link
Copy Source

Summary

Create the foundational skill that encodes software architecture best practices, review checklists, and patterns. This skill serves as the knowledge base for the software-architect agent and all architecture-related commands.

Acceptance Criteria

  • Skill file created at skills/software-architecture/SKILL.md
  • Go-specific best practices documented (package organization, interfaces, error handling, DI, testing)
  • Generic architecture patterns documented (layered architecture, SOLID, dependency direction, module boundaries)
  • Repository health indicators defined
  • Review checklists included (for repo audit, issue refinement, PR review)
  • Anti-patterns to flag documented (god packages, circular deps, leaky abstractions)
  • Skill marked as user-invocable: false in frontmatter

Context

This is the first component of the Software Architect role. The skill will be referenced by:

  • software-architect agent
  • /arch-review-repo command
  • /arch-refine-issue command
  • /review-pr command (enhanced)

Technical Notes

Start with Go-specific patterns since that's the primary language, but include generic patterns that apply across languages. The skill should be comprehensive but focused on practical review guidance.

## Summary Create the foundational skill that encodes software architecture best practices, review checklists, and patterns. This skill serves as the knowledge base for the software-architect agent and all architecture-related commands. ## Acceptance Criteria - [ ] Skill file created at `skills/software-architecture/SKILL.md` - [ ] Go-specific best practices documented (package organization, interfaces, error handling, DI, testing) - [ ] Generic architecture patterns documented (layered architecture, SOLID, dependency direction, module boundaries) - [ ] Repository health indicators defined - [ ] Review checklists included (for repo audit, issue refinement, PR review) - [ ] Anti-patterns to flag documented (god packages, circular deps, leaky abstractions) - [ ] Skill marked as `user-invocable: false` in frontmatter ## Context This is the first component of the Software Architect role. The skill will be referenced by: - `software-architect` agent - `/arch-review-repo` command - `/arch-refine-issue` command - `/review-pr` command (enhanced) ## Technical Notes Start with Go-specific patterns since that's the primary language, but include generic patterns that apply across languages. The skill should be comprehensive but focused on practical review guidance.
HugoNijhuis added a new dependency 2026-01-09 23:00:00 +00:00
#57 Create software-architect agent
HugoNijhuis added a new dependency 2026-01-09 23:00:00 +00:00
#58 Create /arch-review-repo command
HugoNijhuis added a new dependency 2026-01-09 23:00:01 +00:00
#59 Create /arch-refine-issue command
HugoNijhuis added a new dependency 2026-01-09 23:00:01 +00:00
#60 Enhance /review-pr with software architecture review
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
HugoNijhuis (Hugo Nijhuis) fluxcd-bot renovate-bot
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Blocks
#57 Create software-architect agent
flowmade-one/architecture
#58 Create /arch-review-repo command
flowmade-one/architecture
#59 Create /arch-refine-issue command
flowmade-one/architecture
#60 Enhance /review-pr with software architecture review
flowmade-one/architecture
Reference: flowmade-one/architecture#56