map-the-landscape

Solid

Map the big picture around a topic or software repository by identifying its boundaries, layers, actors, components, relationships, flows, history, fault lines, and open questions, then explain how the pieces fit together and where to look next. Use when a user asks to understand a whole field, domain, technology, ecosystem, industry, codebase, architecture, unfamiliar repo, or phrases such as "give me the big picture", "map the landscape", "how does this all fit together?", "help me get oriented", or "what am I missing?"

Web & Frontend 208 stars 8 forks Updated 1 months ago MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
77
Recency 20%
75
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Map the Landscape Build a useful mental model, not an exhaustive catalog. Reveal the structure that makes details make sense: what is inside the boundary, what sits outside it, which relationships matter, how value or data moves, why the landscape looks this way, and where uncertainty remains. ## Set the Zoom Infer these from the request and available context: - **Subject:** the topic, field, ecosystem, or repository to map. - **Mode:** `topic`, `repository`, or `hybrid` when a repo must be placed in its wider ecosystem. - **Audience:** the user's current knowledge and intended use. - **Decision:** what the map should help the user understand or do next. - **Depth:** `snapshot`, `standard`, or `deep`. - **Time horizon:** current state by default; add history when it explains the present. Ask at most one clarifying question only when the subject or intended zoom is genuinely ambiguous. Otherwise state the chosen boundary and proceed. Use `standard` depth unless the user requests a quick overview or a deep study. ## Evidence Discipline Keep the map auditable without making it read like a research paper. - Label important statements as **Observed** when read directly from repository files, **Sourced** when supported by an external source, **Inferred** when deduced from evidence, and **Unknown** when evidence is insufficient. - For current or unstable topic claims, browse and cite authoritative sources. Prefer primary documentation, specifications, papers, rep...

Details

Author
tamdogood
Repository
tamdogood/builder-essential-skills
Created
2 months ago
Last Updated
1 months ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

map-landscape

Chart a repository and the systems it references as a C4 System Landscape plus an application-portfolio table: extract typed reference edges and portfolio facts from tested scripts, commit the result as a landscape record, report drift against it, and render both artifacts into the declared architecture home. Use when: 'map our landscape', 'system landscape', 'what systems do we have', 'what does this repo depend on', 'application portfolio', 'who owns which repo', 'what runtimes are we on', 'chart our repositories', 'C4 context across repos', 'inventory our systems', 'has our landscape drifted'. Skip when: the question is module-level structure inside one codebase (shallow modules, seam placement) which is /architecture:improve, fleet cleanup (stale branches, orphaned worktrees) which is /repo-fleet-hygiene:audit, org settings which is /github:audit, or doc-versus-code drift inside one repository which is /codebase-health:audit.

19 Updated today
melodic-software
Data & Documents Listed

mapping-architecture

Use when asked to analyse, map, document, or diagram a project's architecture, produce a codebase overview, system map, onboarding page, or architecture HTML report, or to explain how an unfamiliar repository fits together.

0 Updated 1 months ago
Facilitra
AI & Automation Listed

topical-map-architect

Design or revise a people-first website information architecture using topics, user needs, entities, page purposes, URL relationships, and contextual internal links. Use for topical maps, content hubs, site trees, content consolidation, coverage gaps, page inventories, navigation planning, or pre-production content architecture.

1 Updated 1 months ago
nipun-arora