feat: add agents/ and workflows/ folders; update README.md and manifest.json

README.md

@@ -18,14 +18,27 @@ This repo answers all of those questions. Think of it as a rolodex — structure
 
 ---
 
-## Files
+## Structure
 
-| File | What it covers |
-|------|---------------|
-| [`llm.txt`](./llm.txt) | Plain-text overview of this repo and the environment |
-| [`manifest.json`](./manifest.json) | Machine-readable index: repos, CI, machines, conventions |
-| [`gitea.llm.md`](./gitea.llm.md) | Local Gitea instance — clone URLs, PAT auth, API examples |
-| [`aws-cli.llm.md`](./aws-cli.llm.md) | AWS account — profiles, S3, Amplify, CloudFront, Lambda |
+```
+llm-tools/
+├── README.md           This file
+├── llm.txt             Plain-text overview for LLM agents
+├── manifest.json       Machine-readable index of everything
+│
+├── gitea.llm.md        Local Gitea instance — clone URLs, PAT auth, API
+├── github.llm.md       GitHub accounts — MathisonProjects + silmaai
+├── aws-cli.llm.md      AWS — profiles, S3, Amplify, CloudFront, Lambda
+│
+├── agents/             Per-agent notes and config
+│   ├── README.md
+│   ├── claude.md
+│   ├── cursor.md
+│   └── codex.md
+│
+└── workflows/          Reusable workflows and automation
+    └── README.md
+```
 
 ---
 
@@ -48,8 +61,10 @@ git clone http://100.79.253.19:3000/jacob-mathison/llm-tools.git
 
 **3. Read the guide for whatever surface you need**
 
-Working with source control → [`gitea.llm.md`](./gitea.llm.md)
+Working with source control (local) → [`gitea.llm.md`](./gitea.llm.md)
+Working with GitHub → [`github.llm.md`](./github.llm.md)
 Working with AWS → [`aws-cli.llm.md`](./aws-cli.llm.md)
+Agent-specific config → [`agents/`](./agents/)
 
 ---
 
@@ -61,9 +76,11 @@ Working with AWS → [`aws-cli.llm.md`](./aws-cli.llm.md)
 | **AWS Default Region** | `us-east-1` |
 | **AWS Profiles** | `default`, `mp-mac-tabitha` |
 | **Gitea** | `http://100.79.253.19:3000` (Tailscale) |
+| **GitHub (public work)** | https://github.com/MathisonProjects |
+| **GitHub (Silma/AI)** | https://github.com/silmaai |
 | **CI Runner** | `orson-runner` — act_runner v0.6.1, host mode, Node 24 on Orson |
 | **Primary dev machine** | `Tabitha` (MacBook Pro arm64, `100.76.192.116`) |
-| **Gitea host** | `Orson` (Mac mini, `100.79.253.19`) |
+| **Gitea host** | `Orson` / `Hagia` (`100.79.253.19`) |
 
 ---
 
@@ -79,7 +96,7 @@ Working with AWS → [`aws-cli.llm.md`](./aws-cli.llm.md)
 
 ## Keeping This Up to Date
 
-When you (a human or an AI agent) add a new service, machine, or repo, update the relevant file and push. The `manifest.json` especially should reflect the live state of the Gitea repo list.
+When a new service, machine, repo, or agent is added, update the relevant file and push. **Always update `manifest.json` and this `README.md`** so the index stays accurate.
 
 ```bash
 cd /Volumes/Hagia/workspaces/workspace_Father/llm-tools

agents/README.md

@@ -0,0 +1,17 @@
+# Agents
+
+Per-agent configuration, context, and notes for AI tools working in this environment.
+
+Each file is tailored to a specific AI coding agent — its quirks, best practices, and how to get the most out of it in Jacob Mathison's stack.
+
+## Agents
+
+| File | Agent | Notes |
+|------|-------|-------|
+| [`claude.md`](./claude.md) | Anthropic Claude (Claude Code / API) | |
+| [`cursor.md`](./cursor.md) | Cursor IDE AI | |
+| [`codex.md`](./codex.md) | OpenAI Codex / ChatGPT with code access | |
+
+## How to Use
+
+When starting a session with one of these agents, point it at the relevant file alongside the surface guides (`gitea.llm.md`, `github.llm.md`, `aws-cli.llm.md`) for full context.

manifest.json

@@ -136,11 +136,29 @@
   },
 
   "files": {
-    "README.md": "Human + AI overview, quick-start, environment at a glance",
+    "README.md": "Human + AI overview, repo structure, quick-start, environment at a glance",
     "llm.txt": "Plain-text overview for LLM agents",
-    "manifest.json": "This file — machine-readable index of repos, tools, and endpoints",
+    "manifest.json": "This file — machine-readable index of repos, tools, endpoints, and structure",
     "gitea.llm.md": "Local Gitea instance — clone URLs, PAT auth, API examples",
     "github.llm.md": "GitHub accounts (MathisonProjects, silmaai) — repos, PAT, CLI patterns",
     "aws-cli.llm.md": "AWS account — profiles, S3 buckets, Amplify apps, CloudFront, Lambda"
+  },
+
+  "directories": {
+    "agents": {
+      "description": "Per-agent configuration, context, and notes for AI coding tools",
+      "files": {
+        "README.md": "Index and usage guide for agent files",
+        "claude.md": "Anthropic Claude (Claude Code / API) — config and notes",
+        "cursor.md": "Cursor IDE AI — config and notes",
+        "codex.md": "OpenAI Codex / ChatGPT with code access — config and notes"
+      }
+    },
+    "workflows": {
+      "description": "Reusable workflows, automation scripts, and prompt chains",
+      "files": {
+        "README.md": "Index and intended contents for workflows"
+      }
+    }
   }
 }

workflows/README.md

@@ -0,0 +1,12 @@
+# Workflows
+
+Reusable workflows and automation scripts for LLM agents working in this environment.
+
+> This folder is a placeholder — add workflow definitions, prompt chains, and automation scripts here as they are developed.
+
+## Intended Contents
+
+- CI/CD workflow templates
+- Deployment automation scripts
+- Prompt chains for common tasks
+- Multi-agent orchestration definitions