{"id":"6dfa93dd-cf89-480f-8273-c4b5392369d8","shortId":"mhSPph","kind":"skill","title":"brownfield-enrich","tagline":"Schema reference for comment enrichment. The enrichment workflow is printed by `wednesday-skills map` in the `[ENRICH]` block — follow those instructions.","description":"## When to use\nThis skill is a schema reference. The full enrichment workflow is printed by `wednesday-skills map`\nin the `[ENRICH]` block when no API key is set — follow those steps directly.\n\nLoad this skill only when you need the `comments-enriched.json` format spec or the enrichment rules.\n\n## What to do\n\n1. Read `.wednesday/codebase/analysis/comments-raw.md`\n   - Each `## \\`dir/\\`` section is one module\n   - **Tagged** table: severity, tag, file, line, comment text\n   - **Substantive untagged** list: developer explanations and architecture notes\n\n2. The `[ENRICH]` block in the terminal output already printed a pre-populated template for\n   `comments-enriched.json`. Use it — fill in the `null` fields for each module.\n\n3. For each module that has tagged or untagged comments, determine:\n   - `purpose`: 1 sentence — what does this module do, inferred from the comments\n   - `techDebt`: `\"high\"` | `\"medium\"` | `\"low\"` | `\"none\"`\n     - high = multiple FIXME/BUG/XXX or systemic HACK/KLUDGE\n     - medium = several TODO/HACK\n     - low = minor TODOs only\n     - none = no debt signals\n   - `isBizFeature`: `true` if this is a business feature (auth, payments, users, orders, notifications...)\n                     `false` if infrastructure (utils, helpers, config, logging, db, cache...)\n   - `ideas`: array of up to 3 concrete improvement suggestions drawn from the comments, or `[]`\n   - Leave `purpose: null` for modules with zero comments — do not invent\n\n4. Write `.wednesday/codebase/analysis/comments-enriched.json` using the **Write tool**\n   (not Bash, not Python — just Write tool directly).\n\n5. Report to dev:\n   - How many modules were enriched\n   - How many are biz features vs infrastructure\n   - Top 3 modules by tech debt\n\n## comments-enriched.json schema\n\nThis is a **flat overlay** — only enrichment fields. The CLI merges it with `comments.json` on load.\nDo NOT copy the full comments.json structure. Write only this shape:\n\n```json\n{\n  \"enrichedAt\": \"2026-03-24T12:00:00.000Z\",\n  \"reversePrd\": \"2–3 paragraphs: what the project does, who uses it, main flows, biggest debt areas\",\n  \"modules\": {\n    \"src/auth\": {\n      \"purpose\": \"Handles JWT-based authentication and session management\",\n      \"techDebt\": \"medium\",\n      \"isBizFeature\": true,\n      \"ideas\": [\"Extract token refresh into a dedicated service\", \"Add rate limiting to login\"]\n    },\n    \"src/utils\": {\n      \"purpose\": \"Shared string/date utilities\",\n      \"techDebt\": \"none\",\n      \"isBizFeature\": false,\n      \"ideas\": []\n    }\n  }\n}\n```\n\n## Never\n- Read raw source files — only read `comments-raw.md`\n- Write Python or Bash scripts to manipulate JSON — use the Write tool directly\n- Run `wednesday-skills map` (full re-parse) — not needed; the CLI picks up enrichment automatically\n- Write to `comments.json` directly — write to `comments-enriched.json` (the overlay)","tags":["brownfield","enrich","agent","skills","wednesday-solutions","agent-skills","ai-agent-skills","ai-skills","claude-code","copilot","cursor","frontend-skills"],"capabilities":["skill","source-wednesday-solutions","skill-brownfield-enrich","topic-agent-skills","topic-ai-agent-skills","topic-ai-skills","topic-claude-code","topic-copilot","topic-cursor","topic-frontend-skills","topic-vibe-coding","topic-vibe-coding-skills"],"categories":["ai-agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/wednesday-solutions/ai-agent-skills/brownfield-enrich","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add wednesday-solutions/ai-agent-skills","source_repo":"https://github.com/wednesday-solutions/ai-agent-skills","install_from":"skills.sh"}},"qualityScore":"0.524","qualityRationale":"deterministic score 0.52 from registry signals: · indexed on github topic:agent-skills · 148 github stars · SKILL.md body (2,867 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T12:54:44.390Z","embedding":null,"createdAt":"2026-04-18T22:09:36.796Z","updatedAt":"2026-05-02T12:54:44.390Z","lastSeenAt":"2026-05-02T12:54:44.390Z","tsv":"'-03':291 '-24':292 '00':294 '00.000':295 '1':78,142 '2':103,298 '2026':290 '3':130,202,254,299 '4':222 '5':237 'add':336 'alreadi':111 'api':52 'architectur':101 'area':312 'array':198 'auth':183 'authent':320 'automat':388 'base':319 'bash':230,362 'biggest':310 'biz':249 'block':22,49,106 'brownfield':2 'brownfield-enrich':1 'busi':181 'cach':196 'cli':270,384 'comment':7,93,139,152,209,218 'comments-enriched.json':68,119,259,395 'comments-raw.md':358 'comments.json':274,282,391 'concret':203 'config':193 'copi':279 'db':195 'debt':173,258,311 'dedic':334 'determin':140 'dev':240 'develop':98 'dir':82 'direct':59,236,371,392 'drawn':206 'enrich':3,8,10,21,37,48,73,105,245,267,387 'enrichedat':289 'explan':99 'extract':329 'fals':188,349 'featur':182,250 'field':126,268 'file':91,355 'fill':122 'fixme/bug/xxx':160 'flat':264 'flow':309 'follow':23,56 'format':69 'full':36,281,377 'hack/kludge':163 'handl':316 'helper':192 'high':154,158 'idea':197,328,350 'improv':204 'infer':149 'infrastructur':190,252 'instruct':25 'invent':221 'isbizfeatur':175,326,348 'json':288,366 'jwt':318 'jwt-base':317 'key':53 'leav':211 'limit':338 'line':92 'list':97 'load':60,276 'log':194 'login':340 'low':156,167 'main':308 'manag':323 'mani':242,247 'manipul':365 'map':18,45,376 'medium':155,164,325 'merg':271 'minor':168 'modul':86,129,133,147,215,243,255,313 'multipl':159 'need':66,382 'never':351 'none':157,171,347 'note':102 'notif':187 'null':125,213 'one':85 'order':186 'output':110 'overlay':265,397 'paragraph':300 'pars':380 'payment':184 'pick':385 'popul':116 'pre':115 'pre-popul':114 'print':13,40,112 'project':303 'purpos':141,212,315,342 'python':232,360 'rate':337 'raw':353 're':379 're-pars':378 'read':79,352,357 'refer':5,34 'refresh':331 'report':238 'reverseprd':297 'rule':74 'run':372 'schema':4,33,260 'script':363 'section':83 'sentenc':143 'servic':335 'session':322 'set':55 'sever':89,165 'shape':287 'share':343 'signal':174 'skill':17,30,44,62,375 'skill-brownfield-enrich' 'sourc':354 'source-wednesday-solutions' 'spec':70 'src/auth':314 'src/utils':341 'step':58 'string/date':344 'structur':283 'substant':95 'suggest':205 'system':162 't12':293 'tabl':88 'tag':87,90,136 'tech':257 'techdebt':153,324,346 'templat':117 'termin':109 'text':94 'todo':169 'todo/hack':166 'token':330 'tool':228,235,370 'top':253 'topic-agent-skills' 'topic-ai-agent-skills' 'topic-ai-skills' 'topic-claude-code' 'topic-copilot' 'topic-cursor' 'topic-frontend-skills' 'topic-vibe-coding' 'topic-vibe-coding-skills' 'true':176,327 'untag':96,138 'use':28,120,225,306,367 'user':185 'util':191,345 'vs':251 'wednesday':16,43,374 'wednesday-skil':15,42,373 'wednesday/codebase/analysis/comments-enriched.json':224 'wednesday/codebase/analysis/comments-raw.md':80 'workflow':11,38 'write':223,227,234,284,359,369,389,393 'z':296 'zero':217","prices":[{"id":"e62ba62b-24b1-4194-b90a-ee7cdb587813","listingId":"6dfa93dd-cf89-480f-8273-c4b5392369d8","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"wednesday-solutions","category":"ai-agent-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:09:36.796Z"}],"sources":[{"listingId":"6dfa93dd-cf89-480f-8273-c4b5392369d8","source":"github","sourceId":"wednesday-solutions/ai-agent-skills/brownfield-enrich","sourceUrl":"https://github.com/wednesday-solutions/ai-agent-skills/tree/main/skills/brownfield-enrich","isPrimary":false,"firstSeenAt":"2026-04-18T22:09:36.796Z","lastSeenAt":"2026-05-02T12:54:44.390Z"}],"details":{"listingId":"6dfa93dd-cf89-480f-8273-c4b5392369d8","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"wednesday-solutions","slug":"brownfield-enrich","github":{"repo":"wednesday-solutions/ai-agent-skills","stars":148,"topics":["agent-skills","ai-agent-skills","ai-skills","claude-code","copilot","cursor","frontend-skills","product-engineering-skills","vibe-coding","vibe-coding-skills"],"license":"mit","html_url":"https://github.com/wednesday-solutions/ai-agent-skills","pushed_at":"2026-04-24T12:57:49Z","description":"Pre-configured agent skills for Vibe Coded projects. These skills provide AI coding assistants (Claude Code, Cursor, etc.) with specific guidelines for code quality and design standards.","skill_md_sha":"c06f853decc2c991cc377dc69b79d389468c28c7","skill_md_path":"skills/brownfield-enrich/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/wednesday-solutions/ai-agent-skills/tree/main/skills/brownfield-enrich"},"layout":"multi","source":"github","category":"ai-agent-skills","frontmatter":{"name":"brownfield-enrich","description":"Schema reference for comment enrichment. The enrichment workflow is printed by `wednesday-skills map` in the `[ENRICH]` block — follow those instructions."},"skills_sh_url":"https://skills.sh/wednesday-solutions/ai-agent-skills/brownfield-enrich"},"updatedAt":"2026-05-02T12:54:44.390Z"}}