diff --git a/AGENTS.md b/AGENTS.md index ebdb6cd..d4af1fc 100644 --- a/AGENTS.md +++ b/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/.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: `.llm.md` in `Tools/` +- Follow the existing file naming pattern: `.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/` | -| Data sources, dashboards, reporting | `Analytics/` | +| Specs, architecture, written context | `documents/` | +| 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 diff --git a/README.md b/README.md index 72f4165..b09f771 100644 --- a/README.md +++ b/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 - └── README.md +├── analytics/ Data sources, dashboards, reporting guides +│ └── 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/.git | Need | Go to | |------|-------| -| Local git repos | [`Tools/gitea.llm.md`](./Tools/gitea.llm.md) | -| GitHub | [`Tools/github.llm.md`](./Tools/github.llm.md) | -| AWS | [`Tools/aws-cli.llm.md`](./Tools/aws-cli.llm.md) | +| Local git repos | [`tools/gitea.llm.md`](./tools/gitea.llm.md) | +| GitHub | [`tools/github.llm.md`](./tools/github.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/) | --- diff --git a/Analytics/README.md b/analytics/README.md similarity index 100% rename from Analytics/README.md rename to analytics/README.md diff --git a/clients/README.md b/clients/README.md new file mode 100644 index 0000000..cdc4501 --- /dev/null +++ b/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 `.md` in this folder, then update `clients/README.md` and the root `manifest.json`. diff --git a/clients/aarete.md b/clients/aarete.md new file mode 100644 index 0000000..8693ac7 --- /dev/null +++ b/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 diff --git a/Documents/README.md b/documents/README.md similarity index 100% rename from Documents/README.md rename to documents/README.md diff --git a/manifest.json b/manifest.json index 7ef138e..25e80ad 100644 --- a/manifest.json +++ b/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" } } } diff --git a/projects/README.md b/projects/README.md new file mode 100644 index 0000000..4810024 --- /dev/null +++ b/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 `.md` in this folder, then update `projects/README.md` and the root `manifest.json`. diff --git a/projects/banner-and-pyre.md b/projects/banner-and-pyre.md new file mode 100644 index 0000000..9152611 --- /dev/null +++ b/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`) diff --git a/projects/silma-ai.md b/projects/silma-ai.md new file mode 100644 index 0000000..b12592d --- /dev/null +++ b/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` diff --git a/Tools/README.md b/tools/README.md similarity index 100% rename from Tools/README.md rename to tools/README.md diff --git a/Tools/aws-cli.llm.md b/tools/aws-cli.llm.md similarity index 100% rename from Tools/aws-cli.llm.md rename to tools/aws-cli.llm.md diff --git a/Tools/gitea.llm.md b/tools/gitea.llm.md similarity index 100% rename from Tools/gitea.llm.md rename to tools/gitea.llm.md diff --git a/Tools/github.llm.md b/tools/github.llm.md similarity index 100% rename from Tools/github.llm.md rename to tools/github.llm.md