refactor: lowercase Tools/Documents/Analytics folders; add clients/ and projects/ with context files; update AGENTS.md, README.md, manifest.json

AGENTS.md

@@ -26,7 +26,7 @@ llm-tools/
 ├── llm.txt             Plain-text summary for rapid LLM ingestion
 ├── manifest.json       Machine-readable index of everything in this repo
 │
-├── Tools/              Access guides for third-party services
+├── tools/              Access guides for third-party services
 │   ├── README.md
 │   ├── gitea.llm.md    Local self-hosted Gitea
 │   ├── github.llm.md   GitHub (MathisonProjects + silmaai)
@@ -41,10 +41,10 @@ llm-tools/
 ├── workflows/          Reusable automation and prompt chains
 │   └── README.md
 │
-├── Documents/          Project specs, architecture docs, written context
+├── documents/          Project specs, architecture docs, written context
 │   └── README.md
 │
-└── Analytics/          Data sources, dashboards, reporting guides
+└── analytics/          Data sources, dashboards, reporting guides
     └── README.md
 ```
 
@@ -54,12 +54,12 @@ llm-tools/
 
 ### Reading
 - Start with `README.md` + `manifest.json` to orient yourself
-- Read the relevant `Tools/` guide before touching any external service
+- Read the relevant `tools/` guide before touching any external service
 - Check `agents/<your-agent>.md` for any agent-specific config or instructions
 
 ### Writing
 - **Always update `README.md` and `manifest.json`** when adding files or folders
-- Follow the existing file naming pattern: `<service>.llm.md` in `Tools/`
+- Follow the existing file naming pattern: `<service>.llm.md` in `tools/`
 - Use [Conventional Commits](https://www.conventionalcommits.org/): `docs:`, `feat:`, `chore:`
 - One concern per file — don't bundle unrelated guides together
 
@@ -67,11 +67,13 @@ llm-tools/
 
 | Content type | Folder |
 |---|---|
-| External service access guide | `Tools/` |
+| External service access guide | `tools/` |
 | Per-agent config / instructions | `agents/` |
 | Reusable prompt chains / automation | `workflows/` |
-| Specs, architecture, written context | `Documents/` |
+| Specs, architecture, written context | `documents/` |
-| Data sources, dashboards, reporting | `Analytics/` |
+| Data sources, dashboards, reporting | `analytics/` |
+| Client engagement context | `clients/` |
+| Internal / personal project context | `projects/` |
 
 ### What NOT to Do
 - Do not commit secrets, tokens, or credentials — reference `credentials/secrets.env` by path only

README.md

@@ -27,7 +27,7 @@ llm-tools/
 ├── llm.txt             Plain-text overview for LLM agents
 ├── manifest.json       Machine-readable index of everything
 │
-├── Tools/              Access guides for external services
+├── tools/              Access guides for external services
 │   ├── README.md
 │   ├── gitea.llm.md    Local Gitea — clone URLs, PAT auth, API
 │   ├── github.llm.md   GitHub — MathisonProjects + silmaai
@@ -42,11 +42,20 @@ llm-tools/
 ├── workflows/          Reusable workflows and automation
 │   └── README.md
 │
-├── Documents/          Project specs, architecture docs, written context
+├── documents/          Project specs, architecture docs, written context
 │   └── README.md
 │
-└── Analytics/          Data sources, dashboards, reporting guides
+├── analytics/          Data sources, dashboards, reporting guides
-    └── README.md
+│   └── README.md
+│
+├── clients/            Per-client context and project notes
+│   ├── README.md
+│   └── aarete.md
+│
+└── projects/           Internal and personal project context
+    ├── README.md
+    ├── silma-ai.md
+    └── banner-and-pyre.md
 ```
 
 ---
@@ -71,10 +80,12 @@ git clone http://100.79.253.19:3000/jacob-mathison/<repo>.git
 
 | Need | Go to |
 |------|-------|
-| Local git repos | [`Tools/gitea.llm.md`](./Tools/gitea.llm.md) |
+| Local git repos | [`tools/gitea.llm.md`](./tools/gitea.llm.md) |
-| GitHub | [`Tools/github.llm.md`](./Tools/github.llm.md) |
+| GitHub | [`tools/github.llm.md`](./tools/github.llm.md) |
-| AWS | [`Tools/aws-cli.llm.md`](./Tools/aws-cli.llm.md) |
+| AWS | [`tools/aws-cli.llm.md`](./tools/aws-cli.llm.md) |
 | Agent-specific config | [`agents/`](./agents/) |
+| Client project context | [`clients/`](./clients/) |
+| Internal project context | [`projects/`](./projects/) |
 
 ---
 

clients/README.md

@@ -0,0 +1,13 @@
+# Clients
+
+Per-client context for AI agents — project background, key contacts, repo locations, and anything else needed to work effectively on client engagements.
+
+## Clients
+
+| File | Client |
+|------|--------|
+| [`aarete.md`](./aarete.md) | Aarete Group |
+
+## Adding a New Client
+
+Create `<client-slug>.md` in this folder, then update `clients/README.md` and the root `manifest.json`.

clients/aarete.md

@@ -0,0 +1,37 @@
+# Aarete Group
+
+Client context for AI agents working on Aarete-related projects.
+
+---
+
+## Overview
+
+Aarete is a management consulting and technology firm. Jacob Mathison is contracted to build out the **DocyAI** platform — an AI-powered document intelligence SaaS product.
+
+---
+
+## Active Projects
+
+| Project | Repo | Stack |
+|---------|------|-------|
+| DocyAI SaaS UI | `jacob-mathison/aarete-doczyai-app` (Gitea) | Next.js, TypeScript, React |
+
+---
+
+## Repositories
+
+### `aarete-doczyai-app`
+- **Gitea:** `http://100.79.253.19:3000/jacob-mathison/aarete-doczyai-app`
+- **Clone:** `git clone http://100.79.253.19:3000/jacob-mathison/aarete-doczyai-app.git`
+- **Stack:** Next.js · TypeScript · React · Tailwind
+- **CI:** Gitea Actions — Build & Lint, Security Audit (runner: `orson-runner`)
+- **Branch:** `main`
+
+---
+
+## Notes for AI Agents
+
+- This is a **private client engagement** — do not push code to any public GitHub repo
+- Use the local Gitea instance for all version control (see `tools/gitea.llm.md`)
+- CI runs on `orson-runner` in host mode — Node 20.x in workflow, Node 24 on host
+- Known issue: `DoomModals.test.tsx` has a timezone-sensitive test (expects CST, runner is PDT) — flag but don't block on it

manifest.json

@@ -107,13 +107,6 @@
     ]
   },
 
-  "conventions": {
-    "default_branch": "main",
-    "commit_style": "conventional-commits",
-    "node_version_ci": "20.x",
-    "package_manager": "npm"
-  },
-
   "github": {
     "accounts": [
       {
@@ -135,6 +128,13 @@
     ]
   },
 
+  "conventions": {
+    "default_branch": "main",
+    "commit_style": "conventional-commits",
+    "node_version_ci": "20.x",
+    "package_manager": "npm"
+  },
+
   "files": {
     "AGENTS.md": "Operational instructions and rules for AI agents working in this repo",
     "README.md": "Human + AI overview, repo structure, quick-start, environment at a glance",
@@ -143,7 +143,7 @@
   },
 
   "directories": {
-    "Tools": {
+    "tools": {
       "description": "Access guides for external services and platforms",
       "files": {
         "README.md": "Index of tool guides and instructions for adding new ones",
@@ -167,16 +167,31 @@
         "README.md": "Index and intended contents for workflows"
       }
     },
-    "Documents": {
+    "documents": {
       "description": "Project specs, architecture docs, and written context for AI agents",
       "files": {
-        "README.md": "Index and intended contents for Documents"
+        "README.md": "Index and intended contents for documents"
       }
     },
-    "Analytics": {
+    "analytics": {
       "description": "Data sources, dashboards, and analytics tooling",
       "files": {
-        "README.md": "Index and intended contents for Analytics"
+        "README.md": "Index and intended contents for analytics"
+      }
+    },
+    "clients": {
+      "description": "Per-client context for AI agents working on client engagements",
+      "files": {
+        "README.md": "Index of client files",
+        "aarete.md": "Aarete Group — DocyAI project context, repos, CI notes"
+      }
+    },
+    "projects": {
+      "description": "Internal and personal project context",
+      "files": {
+        "README.md": "Index of project files",
+        "silma-ai.md": "Silma AI — platform overview, infrastructure, repos",
+        "banner-and-pyre.md": "MP Banner and Pyre — repo suite, Amplify deploy"
       }
     }
   }

projects/README.md

@@ -0,0 +1,14 @@
+# Projects
+
+Context files for internal and personal projects — background, repos, stack details, and working notes for AI agents.
+
+## Projects
+
+| File | Project |
+|------|---------|
+| [`silma-ai.md`](./silma-ai.md) | Silma AI — Jacob's AI assistant platform |
+| [`banner-and-pyre.md`](./banner-and-pyre.md) | MP Banner and Pyre |
+
+## Adding a New Project
+
+Create `<project-slug>.md` in this folder, then update `projects/README.md` and the root `manifest.json`.

projects/banner-and-pyre.md

@@ -0,0 +1,49 @@
+# MP Banner and Pyre
+
+Context for AI agents working on the Banner and Pyre project suite.
+
+---
+
+## Overview
+
+MP Banner and Pyre is a Mathison Projects initiative. It consists of multiple related repositories covering the main application, a migration layer, and a web frontend.
+
+---
+
+## Repositories
+
+| Repo | Location | Branch | Notes |
+|------|----------|--------|-------|
+| `mp-banner-and-pyre` | Gitea: `jacob-mathison/mp-banner-and-pyre` | `main` | Core project |
+| `mp-banner-and-pyre-migration` | Gitea: `jacob-mathison/mp-banner-and-pyre-migration` | `master` | Migration layer |
+| `mp-banner-and-pyre-web` | Gitea + Amplify | `main` | Web frontend |
+
+### Clone URLs (Gitea)
+```bash
+git clone http://100.79.253.19:3000/jacob-mathison/mp-banner-and-pyre.git
+git clone http://100.79.253.19:3000/jacob-mathison/mp-banner-and-pyre-migration.git
+git clone http://100.79.253.19:3000/jacob-mathison/mp-banner-and-pyre-web.git
+```
+
+---
+
+## Deployment
+
+| Surface | Detail |
+|---------|--------|
+| **Amplify App** | `mp-banner-and-pyre-web` — App ID: `d1k6pj7qv29ic0` |
+| **Live URL** | `d1k6pj7qv29ic0.amplifyapp.com` |
+| **AWS Account** | `567637986724` |
+
+```bash
+# Trigger a deployment
+aws amplify start-job --app-id d1k6pj7qv29ic0 --branch-name main --job-type RELEASE
+```
+
+---
+
+## Notes for AI Agents
+
+- Three-repo structure: keep changes coordinated across core, migration, and web
+- `mp-banner-and-pyre-migration` uses `master` as its default branch (legacy)
+- All repos are **private** — use local Gitea only (see `tools/gitea.llm.md`)

projects/silma-ai.md

@@ -0,0 +1,55 @@
+# Silma AI
+
+Context for AI agents working on the Silma AI platform.
+
+---
+
+## Overview
+
+Silma is Jacob Mathison's personal AI assistant — a catgirl AI agent running on OpenClaw. She has persistent memory, a defined personality, calendar/email/Discord/Telegram integrations, and a full local infrastructure stack.
+
+---
+
+## Infrastructure
+
+| Component | Detail |
+|-----------|--------|
+| **Platform** | OCPlatform (custom AI ops platform) |
+| **Host machine** | `Tabitha` — MacBook Pro arm64, `100.76.192.116` |
+| **Install root** | `/Users/Tabitha/.openclaw/` |
+| **Workspace** | `/Users/Tabitha/.openclaw/workspace/` |
+| **k8s namespace** | `silma-ai` on `docker-desktop` |
+
+## Local Services (k8s)
+
+| Service | Port | Notes |
+|---------|------|-------|
+| PostgreSQL + pgvector | `5432` | DB: `silma` |
+| Redis | `6379` | |
+| Elasticsearch | `9200` | |
+| Qdrant | `6333` | Vector DB for semantic memory |
+| MinIO | `9000` / `9001` | S3-compatible storage |
+| Vault | `18200` | Secrets management |
+| Temporal | `7233` | Workflow orchestration |
+| Grafana | `3000` | Metrics dashboards |
+
+---
+
+## Repositories
+
+| Repo | Location | Notes |
+|------|----------|-------|
+| `silma-ai-webapp` | `silmaai/silma-ai-webapp` (GitHub, private) | Silma web app |
+| `silma-backups` | `silmaai/silma-backups` (GitHub, private) | Memory and config backups |
+| `silma-kittens` | `silmaai/silma-kittens` (GitHub, private) | Remote node WebSocket bridge |
+| `silma-usdw` | `silmaai/silma-usdw` (GitHub, private) | U.S. Data Watch app |
+| `mp-silma-webapp` | Amplify App ID: `d390fbhya3a6oy` | Live Amplify deploy |
+
+---
+
+## Notes for AI Agents
+
+- Silma's workspace is at `/Users/Tabitha/.openclaw/workspace/` — treat it as her home directory
+- Memory lives in `memory/` (daily logs) and `MEMORY.md` (curated long-term)
+- Semantic memory uses ChromaDB — searchable via `npm run memory:search`
+- k8s port-forward required before accessing local services: `bash k8s/silma-ai/scripts/port-forward.sh`