🏛️ The Three-Zone Project Harness

The Project Harness is the foundational architecture of AMBA. Unlike traditional chatbots that keep documents in ephemeral web sessions or proprietary cloud silos, AMBA anchors every project to a standard folder on your local computer.

---

📂 The Three Operational Zones

Inside every AMBA project folder, you will find three standardized subdirectories:

Your Project Folder/
├── 📥 input/
├── ⚙️ workings/
└── 📦 output/

1. 📥 input/ — Read-Only Source Materials

This is where you drop all raw business documents:

• Bank statement exports (.xlsx, .csv).
• Invoices and billing registries (.pdf, .csv).
• Client RFP briefs, presentation requirements, and contractor quotes.
• Company rate cards and historical guidelines.

Safety Guarantee

AMBA treats input/ as strictly read-only. The AI agent can read, parse, query, and analyze files in this directory, but it is cryptographically and logically forbidden from modifying, overwriting, or deleting your source files.

---

2. ⚙️ workings/ — Agent Drafting Desk & Calculations

This is the agent's private workshop where intermediate calculations, draft models, and scratchpads live:

• workings/plans/: Where structured implementation plans are saved and updated in-place (e.g. plan_invoice_reconciliation_a7b2.md).
• Domain Namespaces: Multi-department tasks are separated into clean subfolders, such as workings/finance/, workings/media/, and workings/operations/.
• SQL & Data Caches: Ingested SQLite database tables created temporarily for deterministic calculations.

---

3. 📦 output/ — Final Verified Deliverables

This is the only directory where finished, presentable executive artifacts are saved:

• Master financial models and reconciliation workbooks (output/Reconciliation_Report.xlsx).
• Media pitch decks and executive briefings (output/Media_Pitch_Proposal.pdf).
• Board-level presentation decks and summary PDFs (output/Executive_Master_Briefing.pdf).

---

🖱️ Interacting with the Harness in AMBA Studio

In the AMBA Studio interface, the Project Workspace panel lets you:

• Drag and Drop Files: Drop files directly from your desktop into the input/ dropzone.
• Open in Finder / Explorer: Click the folder icon in the studio header to immediately view your actual project directory in macOS Finder or Windows Explorer.
• One-Click Deliverable Inspection: Click on any file in output/ or workings/plans/ to view an instant formatted preview or trigger plan execution.