From 0e823a66bd8c9460556707088d2e2d5f1f22cf9f Mon Sep 17 00:00:00 2001 From: Jacob Mathison Date: Sat, 30 May 2026 23:41:02 -0500 Subject: [PATCH] feat: add agents/ and workflows/ folders; update README.md and manifest.json --- README.md | 37 +++++++++++++++++++++++++++---------- agents/README.md | 17 +++++++++++++++++ agents/claude.md | 0 agents/codex.md | 0 agents/cursor.md | 0 manifest.json | 22 ++++++++++++++++++++-- workflows/README.md | 12 ++++++++++++ 7 files changed, 76 insertions(+), 12 deletions(-) create mode 100644 agents/README.md create mode 100644 agents/claude.md create mode 100644 agents/codex.md create mode 100644 agents/cursor.md create mode 100644 workflows/README.md diff --git a/README.md b/README.md index 43fda58..69b9036 100644 --- a/README.md +++ b/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 diff --git a/agents/README.md b/agents/README.md new file mode 100644 index 0000000..3ddc808 --- /dev/null +++ b/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. diff --git a/agents/claude.md b/agents/claude.md new file mode 100644 index 0000000..e69de29 diff --git a/agents/codex.md b/agents/codex.md new file mode 100644 index 0000000..e69de29 diff --git a/agents/cursor.md b/agents/cursor.md new file mode 100644 index 0000000..e69de29 diff --git a/manifest.json b/manifest.json index f5d323d..5d6c35b 100644 --- a/manifest.json +++ b/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" + } + } } } diff --git a/workflows/README.md b/workflows/README.md new file mode 100644 index 0000000..0b7dede --- /dev/null +++ b/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