Codex-project-manifest

Creates annotated YAML manifests tracking project files, conversation threads, and relationships with unique IDs.

Updated May 16, 2026
One-click install
npx skills add https://github.com/organvm-i-theoria/_agent-ontology --skill codex-project-manifest-organvm-i-theoria
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Codex-project-manifest
Source: https://github.com/organvm-i-theoria/_agent-ontology/tree/main/.agents/skills/claude-project-manifest
Command: npx skills add https://github.com/organvm-i-theoria/_agent-ontology --skill codex-project-manifest-organvm-i-theoria

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Projects accumulate files and conversation history across sessions without a structured record of what exists, why decisions were made, or how artifacts relate to each other. This Skill produces annotated bibliography-style manifests that document files, threads, and dependencies with unique IDs so projects remain navigable and handoff-ready. ## Core Features & Use Cases - Annotated File Inventory: Track every file with a unique ID, type, summary, and rationale-focused notes explaining why design decisions were made. - Conversation Thread Tracking: Log sessions with accomplishments, decisions, files created or modified, and next steps. - Relationship Mapping: Record typed relations (depends_on, implements, supersedes, documents) between entities with annotations. - Use Case: When onboarding a collaborator to an existing project, generate a manifest.yaml from the directory, annotate key files with context, and export a Markdown report so the newcomer understands structure and history without reading every file. ## Quick Start Ask the agent to create a project manifest for the current directory, assigning IDs to each file and summarizing the conversation threads that produced them.

Frequently Asked Questions about Codex-project-manifest

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

FAQPage Schema
How do I create a project manifest documenting files and conversations?▼

Start with the manifest.yaml template, add project metadata with a PROJ-{YEAR}-{SEQ} ID, then add file entries with FILE-XXX IDs, titles, summaries, and notes. Log each work session as a THR-XXX thread entry recording accomplishments and decisions.

What ID format should I use for files and threads in a manifest?▼

Use FILE-{SEQ} for files, THR-{SEQ} for threads, REL-{SEQ} for relations, and PROJ-{YEAR}-{SEQ} for projects, with zero-padded three-digit sequences. Never reuse IDs after deletion; mark removed entities with status: removed instead.

How do I write good annotations for project files?▼

Explain why decisions were made rather than what the code does, since code already shows the what. Include the context that prompted creation, alternatives considered, known limitations, and TODOs, typically in 3-10 lines.

Can I validate a manifest file automatically?▼

Yes, the workflow integration reference includes a Python validation script that checks required fields, ID uniqueness, and reference integrity. A JSON Schema is also provided for use with standard validation tools in CI pipelines.

What output formats does the project manifest support?▼

YAML is the primary format for editing and version control, JSON is available for programmatic access, and a Markdown report template generates human-readable documentation. Templates for all three formats are included in the assets directory.