jayfalls · jayfalls · Mar 8, 2026 · Mar 8, 2026 · Mar 8, 2026 · Mar 8, 2026
diff --git a/.github/hooks/pre-commit b/.github/hooks/pre-commit
diff --git a/.github/workflows/run_tests.yaml b/.github/workflows/run_tests.yaml
diff --git a/README.md b/README.md
@@ -1,25 +1,9 @@
-![Version](https://img.shields.io/badge/version-0.0.0-blue)
+# ACE Framework Documentation
 
-<h1 align="center">🧠 ACE Prototype 🧠</h1>
+## Overview
 
+The ACE Framework is a conceptual cognitive architecture for building ethical autonomous agents. It was developed by David Shapiro et al. at Clemson University and presented in their paper "Conceptual Framework for Autonomous Cognitive Entities" (arXiv:2310.06775).
 
-# Dependencies
+The framework is inspired by the OSI model and uses six hierarchical layers to conceptualize artificial cognitive architectures, ranging from moral reasoning to task execution.
 
-- Before running install
-    - [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
-    - [JQ](https://jqlang.org/download/)
-    - [Podman](https://podman.io/docs/installation)
-    - [Ollama](https://ollama.com/download)
-
-# Usage
-
-```shell
-./ace
-```
-
-## Arguments
-
-- `-s` Stop the ACE
-- `-r` Restart the ACE
-- `--dev` Run the ACE in development mode
-- `--test` Run the ACE tests
+[Source](design/source.md)
diff --git a/ace b/ace
diff --git a/app/component.py b/app/component.py
diff --git a/app/components/__init__.py b/app/components/__init__.py
diff --git a/app/components/actions/__init__.py b/app/components/actions/__init__.py
diff --git a/app/components/actions/start.py b/app/components/actions/start.py
diff --git a/app/components/controller/__init__.py b/app/components/controller/__init__.py
diff --git a/app/components/controller/api/__init__.py b/app/components/controller/api/__init__.py
diff --git a/app/components/controller/api/routes/__init__.py b/app/components/controller/api/routes/__init__.py
diff --git a/app/components/controller/api/routes/model_provider.py b/app/components/controller/api/routes/model_provider.py