feat: add Documents/, Tools/, Analytics/ folders; move tool guides into Tools/; add AGENTS.md; update README.md + manifest.json
This commit is contained in:
@@ -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.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user