Zum Inhalt springen
Kitbay
Einreichen
Skill

architectural-proposals

MITAktualisiert am 11. Nov. 20265.616GitHub-Sterne

A Squad template, copied into the gh-aw repository, on writing architecture proposals before code changes.

Was der Skill vermittelt

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.

Funktionen

  • Structure an architecture proposal document
  • Keep proposal wording specific and evidence-based
  • Re-plan milestones after a foundational change