architectural-proposals
A Squad template, copied into the gh-aw repository, on writing architecture proposals before code changes.
What the skill teaches
A Squad template, copied into the gh-aw repository, on writing architecture proposals before code changes. It lists the sections a proposal in docs/proposals needs: the problem with evidence, the proposed design, what changes and what stays, decisions needed, risks with mitigations, and scope. It sets a tone ceiling that bans hype and vague timelines, explains how to reorder planned waves of work when a proposal changes the foundation, and shows how to frame a recommendation alongside alternatives. Its examples come from the Squad project's own interactive shell proposal.
Capabilities
- Structure an architecture proposal document
- Keep proposal wording specific and evidence-based
- Re-plan milestones after a foundational change
About
- Publisher
- GitHub
- Tool
- Documentation
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Documentation | |
| Publisher | GitHub | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 11, 20265,616 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
More from GitHub
1 server · 108 skills
- GitHub (MCP server)
- secret-scanning (Skill)
- dependency-scanning (Skill)
- chrome-devtools (Skill)
- aws-cdk-python-setup (Skill)
- aws-cloudwatch-investigation (Skill)
Also listed under: Documentation
Sources
- Skill file (SKILL.md)github.com/github/gh-aw · Backs: PublisherNov 10, 2026
- Skill file (SKILL.md)github.com/github/squadNov 13, 2026
- Licence file (LICENSE)github.com/github/gh-aw · Backs: LicenceNov 13, 2026
- Folder in the repository (architectural-proposals)github.com/github/gh-aw · Backs: Includes scriptsNov 10, 2026
- GitHub repositorygithub.com/github/gh-aw · Backs: Activity, LicenceNov 11, 2026