LeoYeAI/agent-master-skills / skills/ariadne-thread
ariadne-thread
VerifiedCreate AI-friendly project structures using progressive disclosure indexing (AGENTS.md, module INDEX.md files, file intent headers). ALWAYS use this skill when the user wants to: create or update AGENTS.md or llms.txt, add INDEX.md files to modules, set up project navigation for AI agents, retrofit an existing codebase with AI-friendly indexes, design module boundaries with explicit dependency and modification-risk documentation, or mentions "AI-friendly project", "progressive disclosure", "project index", "codebase navigation", or "ariadne". Also use when the user asks how to structure a new project so AI tools can navigate it efficiently, even if they don't use these exact terms.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 24.2 KB |
| _meta.json | config | 462 B |
| references/doc-standards.md | markdown | 7.7 KB |
| references/index-maintenance.md | markdown | 2.7 KB |
| references/index-templates.md | markdown | 25.9 KB |
| references/language-adaptation.md | markdown | 4.1 KB |
| references/naming-api-conventions.md | markdown | 10.6 KB |
references/language-adaptation.md
View on GitHub# Language Adaptation
The 4-level index and design principles are universal. Below is how they map to specific language ecosystems.
## C / C++
| Aspect | Convention |
|--------|-----------|
| Directory layout | `include/` + `src/` + `tests/` (compiled); or flat `lib/` (header-only) |
| File naming | `snake_case.h` / `snake_case.cpp` (or `.hpp`/`.cc` per project) |
| Module boundary | Namespace + directory; public API = public headers in `include/` (or entry header for header-only) |
| Build system | CMake (`CMakeLists.txt`), MSBuild (`.sln`/`.vcxproj`), Makefile, or Meson |
| Package manager | vcpkg, Conan, or FetchContent |
| L0 Build commands | CMake: `cmake -B build && cmake --build build && ctest --test-dir build`; MSBuild: `msbuild project.sln /p:Configuration=Release /p:Platform=x64` |
| L2 Contract annotations | Doxygen `@pre`, `@post`, `@throws`, `@threadsafe` |
| Include order | system → third-party → project (with blank line separators) |
| Header guards | `#pragma once` (or `#ifndef PROJECT_MODULE_FILE_H`) |
| Naming | `snake_case` functions, `PascalCase` classes, `kCamelCase` or `SCREAMING_SNAKE` constants |
**Header-only libraries**: All code lives in headers (no `.cpp` files). The "public API" is the entry header (e.g., `library.hpp`) that includes everything. There is no build step for the library itself — consumers include the header and link required system libraries. Tests and examples typically live in separate projects or sibling directories. When indexing, treat the main header directory as a single module with logical sub-groups in `INDEX.md`.
## TypeScript / JavaScript
| Aspect | Convention |
|--------|-----------|
| Directory layout | `src/` flat or by domain; tests co-located as `*.test.ts` |
| File naming | `kebab-case.ts` |
| Module boundary | Directory + barrel `index.ts` (thin, < 20 lines) |
| Build system | `tsc`, esbuild, Vite |
| Package manager | npm, pnpm, bun |
| L2 Contract annotations | JSDoc `@pre`, `@post`, `@throws`, `@sideeffect` |
| Import order | builtins → packages → internal absolute → relative |
| Naming | `camelCase` functions, `PascalCase` classes, `SCREAMING_SNAKE` constants |
## Python
| Aspect | Convention |
|--------|-----------|
| Directory layout | `src/[package]/` + `tests/`; `__init__.py` for packages |
| File naming | `snake_case.py` |
| Module boundary | Package directory + `__init__.py` (public re-exports) |
| Build system | pip, uv, Poetry, setuptools |
| L2 Contract annotations | Docstring sections: `Pre:`, `Post:`, `Raises:`, `Side Effects:` |
| Import order | stdlib → third-party → local (isort / Ruff) |
| Naming | `snake_case` functions, `PascalCase` classes, `UPPER_CASE` constants |
## Go
| Aspect | Convention |
|--------|-----------|
| Directory layout | `cmd/` (entry points) + `internal/` (private) + `pkg/` (public) |
| File naming | `snake_case.go` |
| Module boundary | Package directory; exported = capitalized |
| Build system | `go build`, `go test` |
| L2 Contract annotations | Doc comments with `Precondition:`, `Returns:`, `Errors:` |
| Import order | stdlib → third-party → internal (goimports) |
| Naming | `camelCase`/`PascalCase` (exported), no underscores |
## Rust
| Aspect | Convention |
|--------|-----------|
| Directory layout | `src/` with `lib.rs` / `main.rs`; modules as dirs with `mod.rs` |
| File naming | `snake_case.rs` |
| Module boundary | `mod` + `pub` visibility |
| Build system | Cargo (`cargo build`, `cargo test`) |
| L2 Contract annotations | Doc comments with `# Panics`, `# Errors`, `# Safety` sections |
| Naming | `snake_case` functions, `PascalCase` types, `SCREAMING_SNAKE` constants |
## Java / Kotlin
| Aspect | Convention |
|--------|-----------|
| Directory layout | `src/main/java/...` + `src/test/java/...` (Maven/Gradle) |
| File naming | `PascalCase.java` (one public class per file) |
| Module boundary | Package + module-info.java (Java 9+) |
| Build system | Maven (`mvn`), Gradle (`gradle`) |
| L2 Contract annotations | Javadoc `@throws`, `@apiNote`, custom `@pre`/`@post` tags |
| Naming | `camelCase` methods, `PascalCase` classes, `SCREAMING_SNAKE` constants |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |