visa-claude-md-builder

Consolidate canonical Visa artifacts into a single CLAUDE.md instruction file.

Updated May 4, 2026
One-click install
npx skills add https://github.com/Adgmed2018/visa --skill visa-claude-md-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visa-claude-md-builder
Source: https://github.com/Adgmed2018/visa/tree/main/agents/visa-claude-md-builder
Command: npx skills add https://github.com/Adgmed2018/visa --skill visa-claude-md-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the consolidation of canonical Visa artifacts into a single, optimized agent instruction file (CLAUDE.md or equivalents) to support reliable handoff between teams and engines.

Core Features & Use Cases

  • Reads required artifacts (business_model.md, paradigm_decision.md, data_model.md, design_system.md, gtm_strategy.md, mvp_roadmap.md, acceptance_specs.md) from _visa_sdd/ and produces a consolidated instruction document aligned to visa-1.5.0 conventions for coding agents across engines.
  • Ensures naming consistency and context preservation across the 14-agent pipeline, enabling seamless integration into CLAUDE.md, ANTIGRAVITY.md, AGENTS.md, etc.
  • Supports standardized formatting, versioning, and ready-for-deployment outputs for handoff events.

Quick Start

Invoke the visa-claude-md-builder to generate the consolidated CLAUDE.md from the canonical artifacts in _visa_sdd/, after ensuring all prerequisite files exist.

Frequently Asked Questions about visa-claude-md-builder

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

FAQPage Schema
How do I consolidate multiple markdown artifacts into a single agent instruction file for handoff?

Consolidating markdown artifacts into a single agent instruction file requires reading canonical inputs like business_model.md and data_model.md, then merging them into a deployment-ready document. This Skill automates that consolidation to preserve context for coding agents.

What is the best way to generate a CLAUDE.md file from existing specification documents?

Generating a CLAUDE.md file from specifications involves combining paradigm_decision.md, design_system.md, and acceptance_specs.md into an optimized instruction set. This process aligns the output with visa-1.5.0 conventions for seamless coding agent deployment.

Do I need all canonical artifacts present before building a unified agent instruction?

Yes, all canonical artifacts including gtm_strategy.md and mvp_roadmap.md must exist in the _visa_sdd/ directory before building a unified agent instruction. The consolidation applies during the handoff stage after every prerequisite file is verified.

Can I use this artifact consolidation for coding agents other than Claude?

Yes, artifact consolidation supports multiple coding agents by producing equivalent instruction files like ANTIGRAVITY.md or AGENTS.md. It ensures naming consistency and context preservation across the 14-agent pipeline regardless of the target engine.

Why does my consolidated instruction file lose context during the handoff between teams?

Losing context during handoff happens when canonical artifacts are manually merged without standardized formatting and versioning. This Skill prevents context loss by automatically consolidating inputs into a deployment-ready document that adheres to visa-1.5.0 conventions.