authoring-designs

Standardize technical design documents with scope validation and assumption recording.

8|1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/bostonaholic/team --skill authoring-designs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: authoring-designs
Source: https://github.com/bostonaholic/team/tree/main/skills/authoring-designs
Command: npx skills add https://github.com/bostonaholic/team --skill authoring-designs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the inconsistency and ambiguity in technical design documentation by enforcing a rigorous, standardized authoring procedure that ensures scope validation and autonomous resolution of design trade-offs.

Core Features & Use Cases

  • Scope Validation: Automatically verifies repository boundaries and cross-service dependencies to prevent scope creep.
  • Autonomous Decision Making: Resolves open design questions by recording assumptions and trade-offs, ensuring the human reviewer can audit the logic during PR review.
  • Standardized Templates: Enforces the use of a structured design document format that covers current state, desired end state, patterns, and edge cases.

Quick Start

Ask the team agent to draft a new design document for the proposed feature using the authoring-designs skill.

Frequently Asked Questions about authoring-designs

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

FAQPage Schema
How do I standardize technical design documents to prevent scope creep?

You can standardize technical design documents by enforcing scope validation against repository boundaries and cross-service dependencies, ensuring consistent structure and preventing scope creep across complex engineering tasks.

What is autonomous assumption recording in software design documentation?

Autonomous assumption recording resolves open design questions by documenting trade-offs and assumptions during technical writing, ensuring human reviewers can audit the logic and decision-making process during PR review.

How do I draft a design doc for cross-repository feature coordination?

Drafting design docs for cross-repository coordination requires applying structured templates that enforce scope validation, document current and desired end states, and rigorously analyze edge cases using standardized technical writing rules.

Does writing design docs with ASD-STE100 Simplified Technical English work for complex systems?

Writing design docs with ASD-STE100 Simplified Technical English works for complex systems by reducing ambiguity and enforcing rigorous, standardized authoring procedures for cross-repository software engineering tasks.

When do I need a standardized template for software architecture documentation?

You need a standardized template for software architecture documentation when tackling complex engineering tasks requiring cross-repository coordination, rigorous edge-case analysis, and auditable autonomous resolution of design trade-offs.

What are the limitations of autonomous decision making in design docs?

The limitation of autonomous decision making in design docs is that it requires human reviewers to actively audit recorded assumptions and trade-offs during PR review to validate the autonomous logic and scope boundaries.