Rename product from agent-framework to automaton; move scripts to scripts/ folder

This commit is contained in:
2026-06-12 13:22:10 -04:00
parent 502f47eb21
commit a1391e7364
8 changed files with 16 additions and 16 deletions
+2 -2
View File
@@ -1,8 +1,8 @@
# Adversarial Bug Report: agent-framework (Adversarial Review — Post-Fix) # Adversarial Bug Report: automaton (Adversarial Review — Post-Fix)
## Summary ## Summary
A deep adversarial review of the agent-framework identified **12 bugs** that are difficult to spot — complex logic errors, race conditions, infinite loops, and memory/resource exhaustion issues. All bugs have been fixed. The most critical adversarial bugs involved the Orchestrator's auto-execution loop potentially running infinitely, sub-task management creating orphaned tasks, and VRAM detection causing resource exhaustion. A deep adversarial review of automaton identified **12 bugs** that are difficult to spot — complex logic errors, race conditions, infinite loops, and memory/resource exhaustion issues. All bugs have been fixed. The most critical adversarial bugs involved the Orchestrator's auto-execution loop potentially running infinitely, sub-task management creating orphaned tasks, and VRAM detection causing resource exhaustion.
--- ---
+2 -2
View File
@@ -1,8 +1,8 @@
# Bug Report: agent-framework (Bug Finder Review — Post-Fix) # Bug Report: automaton (Bug Finder Review — Post-Fix)
## Summary ## Summary
A comprehensive bug finder review of the agent-framework identified **18 bugs** (17 new + 1 re-reported from the previous review). All bugs have been fixed. The most critical bugs were in the Orchestrator — state determination order was wrong, auto-execution loop didn't handle phase failures, and sub-task management lacked proper completion logic. A comprehensive bug finder review of automaton identified **18 bugs** (17 new + 1 re-reported from the previous review). All bugs have been fixed. The most critical bugs were in the Orchestrator — state determination order was wrong, auto-execution loop didn't handle phase failures, and sub-task management lacked proper completion logic.
--- ---
+2 -2
View File
@@ -1,11 +1,11 @@
# Verdict: agent-framework # Verdict: automaton
## Status: PASS ## Status: PASS
**Completion Date**: 2026-06-11 **Completion Date**: 2026-06-11
## Summary ## Summary
The agent-framework has a **score of 78** from the Bug Finder and **65** from the Adversarial Bug Finder, for a combined score of **143**. All 30 bugs have been fixed. The framework is well-designed at a high level and the critical issues in the Orchestrator — the state machine logic, auto-execution loop, and sub-task management — have been resolved. automaton has a **score of 78** from the Bug Finder and **65** from the Adversarial Bug Finder, for a combined score of **143**. All 30 bugs have been fixed. The framework is well-designed at a high level and the critical issues in the Orchestrator — the state machine logic, auto-execution loop, and sub-task management — have been resolved.
## Findings ## Findings
+4 -4
View File
@@ -1,4 +1,4 @@
# Agent Framework # Automaton
A contract-based operating system for LLM agents, designed to enforce disciplined engineering workflows. A contract-based operating system for LLM agents, designed to enforce disciplined engineering workflows.
@@ -35,7 +35,7 @@ This will:
- Check for uncommitted changes and warn you - Check for uncommitted changes and warn you
- Pull the latest updates - Pull the latest updates
**Upgrading existing projects:** When the framework is updated, existing projects may need their framework files upgraded (new phases added, new prompts, etc.). To upgrade an existing project, tell the agent: "Upgrade the agent-framework for this project." The agent will check for missing files and update them. **Upgrading existing projects:** When the framework is updated, existing projects may need their framework files upgraded (new phases added, new prompts, etc.). To upgrade an existing project, tell the agent: "Upgrade automaton for this project." The agent will check for missing files and update them.
--- ---
@@ -46,7 +46,7 @@ Once the framework is installed globally, you must "onboard" every individual pr
### Option A: The Agent-Driven Way (Recommended) ### Option A: The Agent-Driven Way (Recommended)
If you want the agent to handle the configuration for you, navigate to your project root and run: If you want the agent to handle the configuration for you, navigate to your project root and run:
> *"Onboard this project into the agent-framework."* > *"Onboard this project into automaton."
The agent will automatically: The agent will automatically:
1. Detect your project type (New, Existing, or Upgrade). 1. Detect your project type (New, Existing, or Upgrade).
@@ -192,7 +192,7 @@ The framework uses a **layered approach** to file management, with a clear prece
When you upgrade the global framework (e.g., after pushing bug fixes), existing projects may need their framework files upgraded. Tell the agent: When you upgrade the global framework (e.g., after pushing bug fixes), existing projects may need their framework files upgraded. Tell the agent:
> "Upgrade the agent-framework for this project." > "Upgrade automaton for this project."
The agent will: The agent will:
1. Compare the project's `.automaton/` files with the global `~/.automaton/` files 1. Compare the project's `.automaton/` files with the global `~/.automaton/` files
+5 -5
View File
@@ -98,7 +98,7 @@ Do not begin any research, implementation, or bug-finding tasks.
## Project Upgrade ## Project Upgrade
When a user asks to "upgrade the agent-framework for this project," the agent should: When a user asks to "upgrade automaton for this project," the agent should:
### Upgrade Process ### Upgrade Process
@@ -129,25 +129,25 @@ The agent should report:
### Example Upgrade Scenarios ### Example Upgrade Scenarios
**Scenario 1: New file added globally** **Scenario 1: New file added globally**
- User says: "Upgrade the agent-framework for this project" - User says: "Upgrade automaton for this project"
- Agent detects that `prompts/test_design.md` is missing from the project's framework - Agent detects that `prompts/test_design.md` is missing from the project's framework
- Agent copies `prompts/test_design.md` from the global framework into the project's framework - Agent copies `prompts/test_design.md` from the global framework into the project's framework
- Agent reports: "Upgraded: Added prompts/test_design.md. Your framework is now up to date." - Agent reports: "Upgraded: Added prompts/test_design.md. Your framework is now up to date."
**Scenario 2: Global file changed, project hasn't customized it** **Scenario 2: Global file changed, project hasn't customized it**
- User says: "Upgrade the agent-framework for this project" - User says: "Upgrade automaton for this project"
- Agent detects that `prompts/orchestrate.md` has changed in the global framework, and the project's version is identical to the old global version - Agent detects that `prompts/orchestrate.md` has changed in the global framework, and the project's version is identical to the old global version
- Agent copies `prompts/orchestrate.md` from the global framework into the project's framework - Agent copies `prompts/orchestrate.md` from the global framework into the project's framework
- Agent reports: "Upgraded: Updated prompts/orchestrate.md. Your framework is now up to date." - Agent reports: "Upgraded: Updated prompts/orchestrate.md. Your framework is now up to date."
**Scenario 3: Global file changed, project has customized it** **Scenario 3: Global file changed, project has customized it**
- User says: "Upgrade the agent-framework for this project" - User says: "Upgrade automaton for this project"
- Agent detects that `prompts/orchestrate.md` has changed in the global framework, and the project's version differs from the global version - Agent detects that `prompts/orchestrate.md` has changed in the global framework, and the project's version differs from the global version
- Agent keeps the project's version of `prompts/orchestrate.md` - Agent keeps the project's version of `prompts/orchestrate.md`
- Agent reports: "Skipped: prompts/orchestrate.md (customized in your project). Your framework is now up to date." - Agent reports: "Skipped: prompts/orchestrate.md (customized in your project). Your framework is now up to date."
**Scenario 4: Multiple changes** **Scenario 4: Multiple changes**
- User says: "Upgrade the agent-framework for this project" - User says: "Upgrade automaton for this project"
- Agent detects: - Agent detects:
- `prompts/test_design.md` is new → **Added** - `prompts/test_design.md` is new → **Added**
- `prompts/workflow.md` has changed, project hasn't customized → **Upgraded** - `prompts/workflow.md` has changed, project hasn't customized → **Upgraded**
+1 -1
View File
@@ -1,6 +1,6 @@
# Workflow State Machine # Workflow State Machine
This file defines the linear progression of a task in the agent-framework. The Orchestrator uses this to determine the next phase. This file defines the linear progression of a task in automaton. The Orchestrator uses this to determine the next phase.
## Task Lifecycle ## Task Lifecycle
View File
View File