jacob-mathison/llm-tools
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Jacob Mathison
2026-05-30 23:49:26 -05:00
parent 9967c6709b
commit c10598d197
14 changed files with 223 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+10 -8
View File
@@ -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/` |
| 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
README.md
+18 -7
View File
@@ -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/<repo>.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/) |
---
Analytics/README.md → analytics/README.md
View File
clients/README.md
+13
View File
@@ -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
+37
View File
@@ -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
Documents/README.md → documents/README.md
View File
manifest.json
+27 -12
View File
@@ -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
+14
View File
@@ -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
+49
View File
@@ -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
+55
View File
@@ -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`
Tools/README.md → tools/README.md
View File
Tools/aws-cli.llm.md → tools/aws-cli.llm.md
View File
Tools/gitea.llm.md → tools/gitea.llm.md
View File
Tools/github.llm.md → tools/github.llm.md
View File