Where are the documentation files stored?

The skill defaults to scanning 'docs/adr/' for records and places technical overviews in a date-stamped feature folder within the 'specs/' directory.

How does this skill help with system integration?

It specifically prompts for system boundaries and integration points, forcing a clear definition of how new components connect to existing infrastructure.

What is an ADR in the context of this skill?

An Architecture Decision Record (ADR) is a document that captures a significant architectural decision, including its context, the decision itself, alternatives considered, and the consequences of that choice.

Does this skill write the actual implementation code?

No, this skill is designed to focus on high-level planning and documentation, purposely excluding code snippets and line-by-line details to trust the implementer with the 'how'.

Architectural Tech Planner

Name: Architectural Tech Planner
Author: jkappers

byjkappers

0•

Learning & Documentation

Generates comprehensive architectural plans and Architecture Decision Records (ADRs) to document system design and technology choices.

The writing-tech-plans skill provides a structured framework for architectural planning and decision-making within the Claude Code environment. It automates the creation of Architecture Decision Records (ADRs) and high-level technical overviews, guiding developers to consider system boundaries, data flow, and trade-offs before implementation begins. By focusing on systemic impact and long-term consequences rather than line-by-line code, this skill ensures that technical choices are well-reasoned, documented, and aligned with security best practices.

Key Features

01Structured data flow and integration mapping

02Standardized ADR creation and automated numbering

03System impact and component boundary analysis

040 GitHub stars

05Comprehensive technical overview generation

06Formalized trade-off and alternative evaluation

Use Cases

01Evaluating and documenting significant technology choices or authentication approaches

02Mapping the architectural impact of complex features before starting implementation

03Maintaining a historical log of design decisions to align engineering teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jkappers/claude-code-software-delivery-plugin writing-tech-plans

For use in Claude.ai and ChatGPT

Download Skill