Mapear
Use to map an existing (brownfield) codebase and produce docs/architecture/assessment.md — stack, architecture, implicit bounded contexts, maturity across the 5 axes, debts/risks, and historical decisions to become retroactive ADRs. Re-running updates the assessment. It is called by /kickoff in brownfield mode, and also runs standalone when the codebase changes or to analyze a repo. Trigger with /mapear.
Install
npx skills add adriannoes/awesome-agentic-ai --skill mapeargit clone --depth 1 https://github.com/adriannoes/awesome-agentic-ai.git /tmp/awesome-agentic-ai
mkdir -p ~/.claude/skills
cp -r /tmp/awesome-agentic-ai/cursor-claude-codex/skills/igoruehara-spec-driven/skills/mapear ~/.claude/skills/mapearPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
> **Translation note:** Originally authored in Portuguese (pt-BR) by Igor Uehara ([igoruehara/spec-driven](https://github.com/igoruehara/spec-driven), MIT). Translated to English by this hub to keep the repository language consistent. Original content unchanged in meaning; see the upstream repo for the pt-BR source. # Skill: Map the current state (as-is) Produces a portrait of a project **already in progress**. First **read the code**, then ask only what the code does not reveal. It is **idempotent**: re-running updates `docs/architecture/assessment.md`. ## Process 1. **Automated mapping:** identify stack, folder structure, architecture style, couplings, tests/CI, logs/metrics/tracing. Infer the **implicit bounded contexts** from the code organization. In large repos, **delegate the scan to an exploration subagent** (see `docs/engineering/_templates/subagent.template.md`) to keep the context lean. 2. **External inputs (if any):** if `/integracoes` connected GitHub/cloud/Confluence (validated account), use them to enrich the as-is. Cite the source. 3. **Gap interview** (`AskUserQuestion`): current business intent and North Star; biggest pains/risks today; domain terms that confuse the team; what MUST NOT break; team context and size. 4. **Gap analysis:** compare the as-is with the SDD standard across the 5 axes (tech stack, architecture, infrastructure, quality, observability). Mark risk (low/medium/high).
Details
- Skill name
mapear- Repository
- adriannoes/awesome-agentic-ai
- Path
cursor-claude-codex/skills/igoruehara-spec-driven/skills/mapear/SKILL.md- License
- MIT
- Repo updated
- 2 November 2026
FAQ
What does the Mapear skill do?
Use to map an existing (brownfield) codebase and produce docs/architecture/assessment.md — stack, architecture, implicit bounded contexts, maturity across the 5 axes, debts/risks, and historical decisions to become retroactive ADRs. Re-running updates the assessment. It is called by /kickoff in brownfield mode, and also runs standalone when the codebase changes or to analyze a repo. Trigger with /mapear.
How do I install the Mapear skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add adriannoes/awesome-agentic-ai --skill mapear. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Mapear popular?
It lives in adriannoes/awesome-agentic-ai, which has 100 GitHub stars and 27 forks, and is included in 2 curated skill lists.
Related skills
Browserstack
100adriannoes/awesome-agentic-ai
Run tests on BrowserStack. Use when user mentions "browserstack", "cross-browser", "cloud testing", "browser matrix", "test on safari", "test on firefox", or "browser compatibility".
Coverage
100adriannoes/awesome-agentic-ai
Analyze test coverage gaps. Use when user says "test coverage", "what's not tested", "coverage gaps", "missing tests", "coverage report", or "what needs testing".
Fix
100adriannoes/awesome-agentic-ai
Fix failing or flaky Playwright tests. Use when user says "fix test", "flaky test", "test failing", "debug test", "test broken", "test passes sometimes", or "intermittent failure".
Meta Skills
47CheshireMew/meta-skills
用于判断一项能力应由模型或 Agent、确定性程序、软件或服务还是组合完成,并选择提示词、模板、Skill、CLI、API、GUI 或插件等合适包装与入口;也用于在创建前查找已有方案,完整理解、创建、改造、审查、蒸馏、迁移、评估和分发 Codex/Agent Skill。用户想选择能力载体,判断某个 Skill 是否好用、为什么走偏、职责是否过宽或过窄、该保留或精简什么,想从对话、项目或另一 Skill 中提炼并吸收可复用能力,设计自我进化、运行资源或完整流程图,或者检查入口、边界、界面信息和真实使用结果时使用。
Loop Library
100adriannoes/awesome-agentic-ai
Discover, find, compare, audit, repair, adapt, and design repeatable AI-agent loops with explicit triggers, actions, verification, stopping conditions, guardrails, and handoffs. Use when a user asks to analyze a codebase for potential loops, mine coding-thread history for work done more than once, turn repeated engineering work into a loop, find or recommend a published loop, create a recurring agent workflow or automation cadence, turn an outcome into a bounded copy-ready loop, or review an existing loop for weak checks, unsafe authority, unbounded repetition, stale state, or unclear stopping
Okta Attack
100adriannoes/awesome-agentic-ai
Okta-as-IdP red-team attack chain — tenant discovery, user enumeration (multiple vectors), authentication flow analysis (factors enumeration, push-notification fatigue, SMS bypass), password spray with lockout discipline, Okta-specific phishing primitives (kits, FastPass abuse, OIDC redirect_uri tampering), MFA enumeration, post-compromise admin API surface. Many enterprise orgs use Okta instead of (or alongside) Entra ID. Distinct endpoints, distinct rate-limiting, distinct factor flows. Use when recon shows `<tenant>.okta.com`, `<tenant>.okta-emea.com`, `<tenant>.oktapreview.com`, or autodis
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.