gen-maps

Generate verifiable YAML code maps for operations, handlers, and repositories.

37|5|Updated Nov 18, 2025
One-click install
npx skills add https://github.com/BellaBe/lean-os --skill gen-maps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gen-maps
Source: https://github.com/BellaBe/lean-os/tree/main/.claude/skills/engineering-gen-maps
Command: npx skills add https://github.com/BellaBe/lean-os --skill gen-maps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates verifiable code maps to catch issues before coding.

Core Features & Use Cases

  • Operation maps: functions, signatures, field accesses
  • Field access declarations: ensures data usage is explicit
  • Verification-ready: maps support later verification

Quick Start

Provide inputs; returns code maps.

Frequently Asked Questions about gen-maps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I catch type mismatches and missing imports before writing code?

Generate code maps—YAML specifications that verify functions, arguments, and imports against type definitions before code generation. Maps catch type mismatches, wrong arguments, and missing imports early in your pipeline, reducing downstream errors and rework.

What are code maps and why use them in a code-generation pipeline?

Code maps are verifiable specifications defining operations, handlers, repositories, and field accesses. They sit between type definitions and code generation, providing a verification layer that validates function signatures, data usage, and import requirements without generating actual code.

When should I generate code maps in my workflow?

Generate code maps after defining types and before generating code. They consume type definitions and location manifests as input, then output operation, handler, and repository maps under artifacts/v{N}/gen/maps with a maps-manifest for later verification.

Can code maps detect field access errors and undeclared data usage?

Yes. Code maps include explicit field access declarations that catch when data is used incorrectly or accessed without declaration, ensuring data usage is traceable and verifiable against your type schema before code generation begins.

What output formats do code maps use?

Code maps are output as YAML specifications stored under artifacts/v{N}/gen/maps alongside a maps-manifest file. These files are verification-ready and designed to be checked against type definitions and location manifests, not as executable code.