skills.rest
juicesharp
juicesharpCOMMUNITY
Explore all skills by this author →
GitHub

annotate-guidance

Generate per-layer architecture.md guidance by analyzing project structure and patterns.

581|102|Updated Apr 18, 2026
Search Tags:#architecture#documentation#guidance#monorepo#codebase-analysis
One-click install
npx skills add https://github.com/juicesharp/rpiv-mono --skill annotate-guidance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: annotate-guidance
Source: https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-pi/skills/annotate-guidance
Command: npx skills add https://github.com/juicesharp/rpiv-mono --skill annotate-guidance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of architecture.md guidance by analyzing a project's structure and patterns, enabling faster onboarding and more accurate AI-assisted reviews.

Core Features & Use Cases

  • Auto-detects project architecture and maps folder structure
  • Writes per-layer architecture.md under .rpiv/guidance mirroring the project's directory layout
  • Supports onboarding and ongoing documentation improvements for AI assistants
  • Batch-writes documentation to maintain a single source of truth across the repository

Quick Start

Run this skill at the repository root to generate and batch-write architecture guidance under .rpiv/guidance/, mirroring your directory structure.

Frequently Asked Questions about annotate-guidance

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

FAQPage Schema
How do I auto-generate architecture documentation for an existing codebase?▼

Generate architecture.md files by analyzing project structure and patterns to produce per-layer documentation under .rpiv/guidance, mirroring the directory layout for onboarding and continuous documentation improvement.

What is the best way to document monorepo architecture layers automatically?▼

Automate monorepo architecture documentation by detecting architectural layers and mirroring the project layout under .rpiv/guidance, batch-writing per-layer architecture.md files to maintain a single source of truth.

Can I use auto-generated architecture guidance docs for AI-assisted code reviews?▼

Use generated architecture guidance docs to provide AI assistants with accurate architectural context, enabling faster onboarding and more precise AI-assisted code reviews for brownfield codebases.

Does architecture documentation generation work for brownfield codebases?▼

Yes, this skill applies to brownfield codebases by automating the discovery of architectural layers and analyzing existing project structure to generate structured architecture.md guidance files.

How do I map my project folder structure to architecture guidance documentation?▼

Map project folder structure to documentation by mirroring the project layout under .rpiv/guidance, generating subfolder architecture.md files that reflect detected architectural layers and target locations.

Why do I need per-layer architecture.md files in my repository?▼

Per-layer architecture.md files maintain a single source of truth across the repository, enabling faster onboarding and more accurate AI-assisted reviews by documenting architectural layers, patterns, and target locations.

Related Skills

Explore More Software Engineering Skills→
telum-aitelum-ai
2

project-import

Create a Speck project structure with a skeleton project.md file.

Official
Basic
juicesharpjuicesharp
581

migrate-to-guidance

Migrate CLAUDE.md files into .rpiv/guidance as architecture.md and update references.

Community
Intermediate
rodmena-limitedrodmena-limited
3

moai-foundation-claude

Create, configure, and manage Claude Code Skills with templates and tools.

Official
Advanced
rochacbrunorochacbruno
866

marmite

Convert markdown files into complete static websites without manual configuration.

Community
Intermediate