Back to Skills

human-architect-mindset

Systematic architectural thinking for irreplaceable human capabilities - domain modeling, systems thinking, constraint navigation, and AI-aware problem decomposition. Use proactively when detecting architectural decisions, system design discussions, or multi-component planning.

359stars50forksUpdated 7/28/2026

Security Assessment

Safe(96/100)
Security Score96/100

About human-architect-mindset

Human Architect Mindset is a conceptual guidance skill that teaches the systematic, human-centered thinking behind software architecture decisions rather than generating code. It starts from the premise that AI can produce code but a human must still decide what to build, whether it solves the real problem, and whether it can actually ship. The skill is organized around a foundation of "loyalty" (the discipline to honor architectural commitments, API contracts, and chosen patterns) plus five pillars: domain modeling, systems thinking, constraint navigation, AI-aware problem decomposition, and AI-first development.

The skill activates proactively when it detects architecture, system design, technology-choice, integration-planning, breaking-change, or compliance discussions, announcing itself and then walking the user through structured phases such as domain discovery, systems analysis, and constraint mapping. Supporting files (EXAMPLES.md, CHECKLIST.md, REFERENCE.md) provide worked scenarios like a payment-pipeline SDK breakage, a HIPAA-constrained healthcare EHR integration, and a multi-team feature rollout, each illustrating how to find the "shippable" solution when the technically "correct" one is unshippable, and how to draw good AI task boundaries.

It is aimed at software architects, senior/staff engineers, and technical leads who want a repeatable way to reason about messy, real-world constraints (legacy systems, politics, budget, compliance) and to decompose problems into AI-solvable chunks. It is best used as a thinking aid during design conversations and reviews, not as an implementation or code-generation tool.

FAQ

What does this skill actually produce?

It produces structured architectural reasoning, not code. It guides you through phases like domain discovery, systems analysis, and constraint mapping, and helps you set good task boundaries for AI-assisted work.

When does it activate?

Proactively, when it detects keywords and patterns around architecture, system design, integration, breaking changes, migration, compliance, multi-team dependencies, or AI-first/agentic decisions.

Who is it for?

Architects, senior and staff engineers, and technical leads making decisions that affect multiple components, teams, or that carry compliance implications.

Are there concrete examples to learn from?

Yes. EXAMPLES.md covers a payment-pipeline SDK failure, a HIPAA/HL7 healthcare integration, and a three-team feature rollout, each showing how to navigate technical, organizational, and political constraints.

Is it a substitute for writing or reviewing code?

No. It is a mindset and decision-framework skill; it deliberately focuses on what to build and whether it can ship, and defers actual implementation to other tools.

All Files

4 files
EXAMPLES.md22.8 KB
View
CHECKLIST.md18.7 KB
View
REFERENCE.md22.0 KB
View
SKILL.md29.5 KB
View

Install human-architect-mindset

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill