How does it help with naming conventions?

It identifies 'irreducible nouns' and eliminates aliases, ensuring every concept in your system has a single, canonical name and clear ownership across the entire stack.

Can it assist with error handling and reliability?

Yes, it includes a stress-testing phase that walks through failure, retry, and recovery flows to ensure the conceptual model remains valid during unexpected system states.

What is the Systems Cartographer skill?

Systems Cartographer is a specialized Claude Code capability designed to help developers define and refine the conceptual architecture, terminology, and state logic of complex software systems.

What kind of outputs does Systems Cartographer provide?

It generates a canonical glossary, concept Directed Acyclic Graphs (DAGs), lifecycle diagrams, boundary maps, and a matrix of invariants and recovery procedures.

When is the best time to use this skill?

Use it when starting a new project, planning a major refactor, or when you notice inconsistencies and naming collisions between your API, UI, and internal data structures.

Systems Cartographer

Name: Systems Cartographer
Author: lherron

bylherron

0•

API 개발

Builds ground-up conceptual models and architectural frameworks for complex systems by defining core nouns, invariants, and lifecycles.

Systems Cartographer acts as a specialized architectural partner that helps developers rebuild or refine a system's conceptual model from first principles. By identifying irreducible concepts and reconciling mismatched terminology across APIs and UIs, it creates a robust foundation for refactors, redesigns, and new implementations. It excels at uncovering hidden states, defining strict system boundaries, and stress-testing logic against real-world failure scenarios to ensure a minimal, consistent, and scalable architecture that explains all system behaviors without implementation leak.

주요 기능

01Invariant and boundary mapping to clarify state ownership and responsibilities

020 GitHub stars

03First-principles conceptual modeling and domain language definition

04Lifecycle state machine drafting for key domain entities

05Model stress-testing against failure paths and edge case scenarios

06Terminology reconciliation across API, UI, and internal type systems

사용 사례

01Refactoring legacy systems with inconsistent naming and unclear state ownership

02Aligning API schemas with front-end requirements and internal business logic

03Designing a new system's core architecture and domain vocabulary from scratch

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lherron/agent-metaskills systems-cartographer

For use in Claude.ai and ChatGPT

Download Skill