high-fidelity-context-scaffolder

Generate .agents/AGENTS.xml and ARCHITECTURE.xml from repository analysis or AGENTS.md migration.

Updated Nov 15, 2025
One-click install
npx skills add https://github.com/CowboyLogic/ai-dev --skill high-fidelity-context-scaffolder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: high-fidelity-context-scaffolder
Source: https://github.com/CowboyLogic/ai-dev/tree/main/skills/high-fidelity-context-scaffolder
Command: npx skills add https://github.com/CowboyLogic/ai-dev --skill high-fidelity-context-scaffolder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of a High-Fidelity XML scaffold to manage and deploy AI agent directives, replacing fragile Markdown governance with a structured, machine-readable model.

Core Features & Use Cases

  • Generate a .agents/ folder containing AGENTS.xml and ARCHITECTURE.xml from repository analysis or migration of existing AGENTS.md.
  • Produce a root AGENTS.md shim that points agents to the XML manifest, preserving discoverability.
  • Support both migration (AGENTS.md present) and new-repo analysis workflows to bootstrap agent infrastructure.

Quick Start

Run the scaffolder at the repository root to generate .agents/AGENTS.xml, .agents/ARCHITECTURE.xml, and AGENTS.md shim.

Frequently Asked Questions about high-fidelity-context-scaffolder

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

FAQPage Schema
How do I migrate existing AGENTS.md directives to a structured XML format?

To migrate AGENTS.md directives to XML, the scaffolder analyzes your existing Markdown file and generates .agents/AGENTS.xml and .agents/ARCHITECTURE.xml. It creates a root AGENTS.md shim pointing to the XML manifest, preserving agent discoverability while replacing fragile Markdown governance.

What is the best way to generate AI agent directives for a new repository?

Generating AI agent directives for a new repository involves analyzing the repository structure to bootstrap agent infrastructure. The scaffolder produces .agents/AGENTS.xml and .agents/ARCHITECTURE.xml files with a repository-scoped metadata schema, enforcing machine-readable governance from built-in templates.

Why use XML instead of Markdown for AI agent repository governance?

XML provides structured, machine-readable governance replacing fragile Markdown for AI agents. XML directive suites enforce a repository-scoped metadata schema with explicit path mappings, ensuring reliable agent interpretation compared to unstructured Markdown files.

Can I bootstrap agent infrastructure in a repository without an existing AGENTS.md file?

Yes, you can bootstrap agent infrastructure without an existing AGENTS.md file. The scaffolder supports new-repo analysis workflows, directly analyzing your repository structure to produce .agents/AGENTS.xml, .agents/ARCHITECTURE.xml, and an AGENTS.md shim for discoverability.

What files are generated in the .agents folder by the scaffolder?

The scaffolder generates .agents/AGENTS.xml and .agents/ARCHITECTURE.xml files containing the repository-scoped metadata schema. It also outputs a root AGENTS.md shim file that points agents to the XML manifest, ensuring explicit path mappings and agent discoverability.