# Context Ingestion > > **OpenClaw Integration:** This skill is invoked by the Dojo Genesis plugin via `/dojo run context-ingestion`. - Skill: `dojogenesis/context-ingestion-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add dojogenesis/context-ingestion-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/dojogenesis/context-ingestion-2/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Integrations & APIs, Productivity, Research & Search - Author: DojoGenesis (https://skillmd.com/u/dojogenesis) - Updated: 2026-09-21 - Page: https://skillmd.com/skills/dojogenesis/context-ingestion-2 --- > **OpenClaw Integration:** This skill is invoked by the Dojo Genesis plugin via `/dojo run context-ingestion`. > The agent receives project context automatically via the `before_agent_start` hook. > Use `dojo_get_context` for full state, `dojo_save_artifact` to persist outputs, > and `dojo_update_state` to record phase transitions and decisions. # Context Ingestion Workflow **Version:** 1.0 **Created:** 2026-02-08 **Author:** Manus AI **Purpose:** To create plans that are deeply informed by uploaded content, ensuring that recommendations are specific, actionable, and aligned with the provided context. --- ## I. The Philosophy: Grounding is Everything The quality of a plan is directly proportional to how well it is grounded in the available context. This skill transforms file uploads from passive attachments into active participants in the planning process, ensuring that every recommendation is rooted in the specifics of the provided files. --- ## II. When to Use This Skill - **When you have 1-2 files** and a general planning request (e.g., "create a plan from this spec"). - **When you need to refactor a codebase** and have uploaded the relevant files. - **When you want to create action items** from meeting notes or a design document. - **When the `planning-with-files` meta-skill routes to this mode.** --- ## III. The Workflow This is a 5-step workflow for creating grounded plans from uploaded files. ### Step 1: File Ingestion and Cataloging **Goal:** Read all uploaded files and create a structured catalog of their content. 1. **Read Files:** Use the `file` tool to read each uploaded file (use `view` for images/PDFs). 2. **Extract Content:** For PDFs, extract text. For code, identify structure. For images, describe visual content. 3. **Create Catalog:** Create an internal catalog document listing all files and their key content. ### Step 2: Context Synthesis **Goal:** Synthesize the file content into a coherent understanding of the current state. 1. **Identify Patterns:** Look for recurring themes, architectural decisions, and coding conventions across files. 2. **Extract Constraints:** Note any explicit or implicit constraints (e.g., "must maintain backward compatibility"). 3. **Identify Opportunities:** Note areas for improvement or refactoring. 4. **Note Contradictions:** If files contradict each other, call this out explicitly. ### Step 3: Plan Creation **Goal:** Create a detailed plan grounded in the synthesized context. 1. **Define Phases:** Break the plan into clear phases with estimated durations. 2. **Specify Actions:** For each phase, list specific actions grounded in the uploaded files (reference file names and line numbers where relevant). 3. **Define Deliverables:** Specify concrete deliverables for each phase. 4. **Set Success Criteria:** Define binary, testable success criteria. 5. **Identify Risks:** List potential risks and their mitigations. ### Step 4: Validation and Refinement **Goal:** Ensure the plan is complete, actionable, and aligned with the user's intent. 1. **Review for Completeness:** Check that all phases have clear deliverables and success criteria. 2. **Verify Grounding:** Ensure that all recommendations are directly tied to the uploaded files. 3. **Check for Actionability:** Verify that the plan can be executed immediately without needing additional context. ### Step 5: Delivery **Goal:** Deliver the plan to the user with clear next steps. 1. **Send Plan:** Use the `message` tool to send the plan as an attachment. 2. **Summarize:** Briefly summarize the key phases and deliverables. 3. **Offer Refinement:** Offer to answer questions or refine the plan based on feedback. --- ## IV. Best Practices - **Reference Specifics:** Always reference specific files, functions, or sections in the plan. - **Make Constraints Explicit:** If you find constraints in the files, list them in the plan. - **Write Actionable Plans:** Use clear phases, concrete deliverables, and binary success criteria. - **Synthesize Before Planning:** Create an internal synthesis document before writing the plan to ensure deep understanding. --- ## V. Quality Checklist - [ ] Does the plan reference specific files and line numbers? - [ ] Does the plan explicitly list any constraints found in the files? - [ ] Does the plan have clear phases with concrete deliverables and binary success criteria? - [ ] Is the plan actionable without needing additional context? --- ## OpenClaw Tool Integration When running inside the Dojo Genesis plugin: 1. **Start** by calling `dojo_get_context` to retrieve full project state, history, and artifacts 2. **During** the skill, follow the workflow steps documented above 3. **Save** outputs using `dojo_save_artifact` with the `artifacts` output directory 4. **Update** project state by calling `dojo_update_state` to record skill completion and any phase transitions