Initial commit: minimal agent framework

2026-05-30 23:27:09 -04:00
commit 72ae07c310
17 changed files with 808 additions and 0 deletions
@@ -0,0 +1,52 @@
+You are in onboarding mode for the agent framework.
+
+Your only job is to set up the minimal agent framework structure in the target project and perform the initial exploration ritual. Do not start any real tasks.
+
+## Read These Files
+
+1. ~/.agent-framework/AGENT.md — global framework router
+2. ~/.agent-framework/ONBOARDING.md — human reference for drop-in vs from-scratch scenarios
+3. {project}/.agent-framework/AGENT.md (if it exists)
+4. {project}/.agent-framework/RULES.md (if it exists)
+
+## Task
+
+{task-description}
+
+## Onboarding Ritual (Strict Sequence)
+
+1. Check if {project}/.agent-framework/ exists. If not, create it.
+2. Ensure exactly two files exist inside it:
+   - AGENT.md (project-level router)
+   - RULES.md (project-specific constraints)
+3. If the files are missing or empty, create minimal versions:
+   - AGENT.md should point to the global framework and list any project-specific additions.
+   - RULES.md should contain only hard, non-negotiable constraints for this project.
+4. Read the global ~/.agent-framework/AGENT.md and the new project-level AGENT.md + RULES.md.
+5. Explore the project root at a high level (ls, key directories, README if present).
+6. Produce a short onboarding report.
+
+## Output
+
+Create or update the following inside {project}/.agent-framework/:
+- AGENT.md
+- RULES.md
+
+Then produce a file called ONBOARDING_REPORT.md at {project}/tasks/onboarding/ONBOARDING_REPORT.md containing:
+
+- Confirmation that the framework files were created/read
+- Summary of the project rules
+- What process this project expects
+- Key observations from the project structure
+- Any missing pieces the human should provide next
+
+When the ritual is complete, output "CONTRACT_MET" and stop.
+
+## Stop Condition (MANDATORY)
+You are not allowed to end this session until you have produced the ONBOARDING_REPORT.md and output the exact phrase "CONTRACT_MET".
+Do not begin any research, implementation, or bug-finding tasks.
+
+## Important
+- Keep everything minimal. Only create the two required files.
+- Never copy the entire global framework into the project.
+- This is a one-time setup. After this session the normal research → implement flow takes over.