planning-architecture

Orchestrates SSOT-to-plan translation for ADR-driven architecture updates.

Updated Aug 18, 2025
One-click install
npx skills add https://github.com/masa-codehub/gemini_agent --skill planning-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-architecture
Source: https://github.com/masa-codehub/gemini_agent/tree/main/.gemini/skills/planning-architecture
Command: npx skills add https://github.com/masa-codehub/gemini_agent --skill planning-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

What problem does it solve?

The Architecture Planning skill orchestrates the initial phase of architecture updates by reading the Single Source of Truth (SSOT) and ADRs, formulating a visualization strategy, creating common definitions, drafting individual and integration issues, and submitting a plan for approval. This helps teams align on scope, terminology, and the sequence of work before implementation begins.

Core Features & Use Cases

  • Orchestrates SSOT-to-plan translation for ADR-driven updates.
  • Generates common definitions and ensures consistent terminology across artifacts.
  • Slices work into discrete issues (individual and integration), linking to the shared definitions and templates.
  • Produces a plan ready for review and PR-based approval, with clear dependencies and mapping.

Quick Start

Start by activating the switching-feature-branch skill to create a feature branch, then run scoping-design-tasks to generate the Design Brief.

Frequently Asked Questions about planning-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate ADR-driven architecture updates into an executable plan?

Architecture planning translates ADR-driven updates into an executable plan by reading the SSOT, generating common definitions, and drafting integration issues for review. It extracts design briefs and maps bounded contexts to align teams before implementation begins.

What is the best way to create audit-ready documentation for cross-team architecture upgrades?

Creating audit-ready documentation for cross-team architecture upgrades involves orchestrating SSOT-to-plan translation using defined templates and references. It ensures consistent terminology across artifacts while slicing work into discrete, dependency-linked issues for approval.

How does bounded-context mapping work during preliminary architecture design?

Bounded-context mapping during preliminary architecture design works by extracting design briefs from the SSOT and formulating a visualization strategy. This process creates common definitions that ensure consistent terminology across all subsequent integration artifacts and issues.

Do I need a feature branch to start planning an architecture update?

You need a feature branch to start planning an architecture update. The quick start process requires activating a switching-feature-branch skill first, then running scoping-design-tasks to generate the Design Brief before orchestrating the full plan.

Can I submit a cross-team architecture plan for PR-based approval?

You can submit a cross-team architecture plan for PR-based approval. The process produces a plan with clear dependencies and mapping, ready for review by linking discrete individual and integration issues to shared definitions and templates.

When should I not use an SSOT-driven approach for architecture planning?

You should not use an SSOT-driven approach for architecture planning when your project lacks established ADR governance or a centralized Single Source of Truth. This method relies on reading existing ADRs and SSOTs to formulate visualization strategies and common definitions.