The "Seed of a Project" concept is an innovative approach to AI-driven development where an entire project can be initiated and guided from a single, comprehensive instruction file. This method allows AI agents to autonomously set up, plan, and execute development tasks.
To cut down a tree in five minutes spend three minutes sharpening your axe.— Abraham Lincoln (attributed)
What is a "Seed" File?
A "Seed" file is a master instruction document that, when provided to a high-tier AI model (e.g., within Cursor) with a simple command like "Start," empowers the AI to independently create all necessary project components and define subsequent tasks. This file acts as the project's foundational blueprint, outlining goals, architectural principles, and operational directives for the AI.
The power of the "Seed" concept lies in its "AI Autonomy Directive", which instructs the AI to:
Orient Itself: The AI first locates and parses project status files like
DEVELOPMENT_STATUS.jsonandPROMPT_TRACKING.jsonto understand the current project status, thelast_completed_prompt_id, and thenext_planned_prompt_id. If these files don't exist, the AI recognizes it's a fresh start. It then thoroughly reviews the "Active Instruction Document" (the Seed file) and its parsed derivatives to grasp project goals, architecture, module responsibilities, and the specifics of the next task.Acknowledge Understanding: The AI confirms its understanding of the project's current status and the immediate next task.
Check Assets: It verifies available assets against a
user_assets_manifest.json.Execute Autonomously:
If
DEVELOPMENT_STATUS.jsonindicates anext_planned_prompt_id, the AI immediately begins that task.For new projects without existing status files, the AI identifies the initial setup task (e.g.,
TASK-SYS-001) from the Seed file and autonomously develops and proposes the necessary script (e.g.,project_init.py) without requiring further permission.For all subsequent tasks, the AI executes the
next_planned_prompt_iddefined inDEVELOPMENT_STATUS.json.Throughout execution, the AI uses the Seed file and its derivatives as the primary guide, adhering to a defined "Autonomous Execution Policy". The AI is explicitly instructed not to ask for permission for routine or well-defined steps, only pausing for genuine ambiguities, missing information, or critical decision points not covered by the plan.
The Seed concept incorporates "Core Behavioral Rules" to govern the AI's actions:
Autonomous Progression: The AI progresses autonomously through tasks and phases outlined in tracking files.
Human Intervention Policy: The AI only pauses or requests human intervention if explicitly required, if a critical ambiguity prevents progress, or if a tool repeatedly fails.
Tool Usage: It utilizes defined helper CLI tools, with direct file manipulation as a fallback if tools fail.
Tracking File Management: The AI proactively manages
PROMPT_TRACKING.json,DEVELOPMENT_STATUS.json, andHUMAN_ACTION_ITEMS.json.Parsed File Preference: After initial setup, the AI prefers using parsed output files for task details.
A crucial element for handling complex projects is the "AI-Driven Sub-Task Generation Protocol". When the AI identifies an active prompt as too complex, it:
Consults the Plan: Reviews the Seed file and core principles to ensure alignment.
Defines Sub-Prompts: Creates 2-5 smaller, actionable sub-prompts, each with a clear description and Definition of Done (DoD) criteria. This process can be recursive.
Assigns IDs: Assigns unique IDs to each sub-prompt.
Logs Sub-Prompts: Adds these sub-prompts to
PROMPT_TRACKING.json.Updates Parent: Changes the status of the original complex prompt to "Decomposed" or "Blocked by Sub-tasks".
Proceeds Sequentially: Makes the first generated sub-prompt its active task.
Real-World Applications
The effectiveness of this concept is limited by the quality of the fallback mechanisms and instructions offered, constrained by a natural limit of 1000 lines. More than that and the models struggle to keep their actions in synchrony with the instruction file. But this is bound to change in future versions of the agents.
The "Seed of a Project" concept transforms a single instruction file into a dynamic engine for AI-driven development, enabling more efficient and autonomous project execution.
Remember you can pass this article's URL into you agent and say "use this article as reference and create me a Seed.md file for a project <like this>"
Pablo Dominguez
Full Stack Developer passionate about building interesting projects and learning new skills.