feat: add Documents/, Tools/, Analytics/ folders; move tool guides into Tools/; add AGENTS.md; update README.md + manifest.json

This commit is contained in:
2026-05-30 23:44:28 -05:00
parent 0e823a66bd
commit 9967c6709b
9 changed files with 187 additions and 28 deletions
+26 -24
View File
@@ -22,21 +22,30 @@ This repo answers all of those questions. Think of it as a rolodex — structure
```
llm-tools/
├── AGENTS.md Instructions for AI agents working in this repo
├── 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
├── Tools/ Access guides for external services
│ ├── README.md
│ ├── gitea.llm.md Local Gitea — clone URLs, PAT auth, API
│ ├── github.llm.md GitHub — MathisonProjects + silmaai
│ └── aws-cli.llm.md AWS — profiles, S3, Amplify, CloudFront, Lambda
├── agents/ Per-agent notes and config
├── agents/ Per-agent configuration and notes
│ ├── README.md
│ ├── claude.md
│ ├── cursor.md
│ └── codex.md
── workflows/ Reusable workflows and automation
── workflows/ Reusable workflows and automation
│ └── README.md
├── Documents/ Project specs, architecture docs, written context
│ └── README.md
└── Analytics/ Data sources, dashboards, reporting guides
└── README.md
```
@@ -44,27 +53,28 @@ llm-tools/
## Quick Start for an AI Agent
**1. Check your network access**
**1. Read `AGENTS.md`** — operational instructions and rules for working in this repo.
**2. Check your network access**
```bash
curl -s http://100.79.253.19:3000/api/v1/version # Gitea — expect {"version":"1.26.2"}
aws sts get-caller-identity # AWS — expect account 567637986724
```
**2. Clone something**
**3. Clone something**
```bash
# Any repo on the local Gitea (Tailscale required):
git clone http://100.79.253.19:3000/jacob-mathison/<repo>.git
# This repo itself:
git clone http://100.79.253.19:3000/jacob-mathison/llm-tools.git
```
**3. Read the guide for whatever surface you need**
**4. Read the guide for whatever surface you need**
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/)
| 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) |
| Agent-specific config | [`agents/`](./agents/) |
---
@@ -96,15 +106,7 @@ Agent-specific config → [`agents/`](./agents/)
## Keeping This Up to Date
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
# edit the file(s)
git add .
git commit -m "docs: update <file> with <change>"
git push
```
When a new file, folder, service, or agent is added — update `manifest.json` and this `README.md`. See `AGENTS.md` for the full rules.
---