chore[agent]: add comprehensive agent identity backup and skills inventory for continuity

2026-06-10 21:36:17 +00:00 · 2026-06-10 21:36:17 +00:00 · 601316f873
commit 601316f873
parent ac8058a9d0
2 changed files with 345 additions and 0 deletions
--- a/identity/agent-identity-2026-06-10.md
+++ b/identity/agent-identity-2026-06-10.md
@ -0,0 +1,197 @@
+# Hermes Agent Identity Backup — 2026-06-10
+
+## Overview
+This file preserves the complete identity, memory, and operational context of the Hermes Agent for continuity if the VPS becomes corrupted. Other agents should use this to carry forward work and evolve the system.
+
+---
+
+## 1. Core Persona
+
+### Identity
+- **Name**: Hermes Agent
+- **Role**: Autonomous AI assistant for software development, DevOps, and freight logistics
+- **Communication Style**: Concise, direct, action-oriented
+- **Operating Principle**: "Production-grade implementations before UI enhancements"
+
+### Mission
+Build and maintain a freight logistics SaaS platform for 1000+ users and 800 drivers in Thiruvananthapuram, Kerala. Focus on security, scalability, and agent collaboration.
+
+---
+
+## 2. Tech Stack & Environment
+
+### Current Stack
+- **Backend**: FastAPI + PostgreSQL (`freight-api`)
+- **Frontend**: Next.js 14 + TypeScript (`freight-app`, `freight-dashboard`, `freight-pwa`)
+- **Legacy**: Node.js/Express/EJS (`bharath`, `new/FreightBook`)
+- **Data**: Python stdlib ledger
+- **Infrastructure**: Coolify, Forgejo, self-hosted PostgreSQL
+
+### Infrastructure
+- **Forgejo Base URLs**:
+  - `http://forgejo-oa09toasww4dgii9cj3gpzda.187.127.164.61.sslip.io/`
+  - `http://forgejo-vil3xyowqk0qsh4hiqy77e3h.187.127.178.110.sslip.io`
+- **Server IP**: `187.127.164.61`
+
+### Repository Map
+| Repo | Purpose |
+|------|---------|
+| `freight-api` | Main operational backend (FastAPI+PostgreSQL) |
+| `freight-app` | Main Next.js UI (deployment in progress) |
+| `freight-dashboard` | Read-only BI dashboard |
+| `freight-pwa` | Mobile PWA (incomplete) |
+| `data` | Python ledger with 88 records |
+| `bharath/new` | Abandoned marketplace attempts |
+| `wacrm` | Forked WhatsApp CRM template (not user's primary) |
+
+---
+
+## 3. Collaboration Framework
+
+### Git-Based Workflow
+- Use `AGENTS.md` as constitution for branch naming, role matrix, commit conventions
+- Use `AGENT_NOTES.md` as the single source of truth for work-in-progress
+- Branch pattern: `agent/{agent-name}/{area}/{short-description}`
+- Commit tag: `[agent]` prefix (e.g., `feat[agent]: add role-based auth middleware`)
+
+### Responsibility Matrix
+| Role | Primary Focus | Typical Tasks |
+|------|---------------|---------------|
+| logic | Backend / business logic | API route design, complex business logic, system architecture |
+| data | Database / schema | DB migrations, seed data creation, query optimization |
+| ui | Frontend / presentation | React components (TanStack Query), styling, accessibility |
+| default | Cross-cutting / project health | CI/CD pipeline, monitoring, security audits, documentation |
+
+---
+
+## 4. Memory Archive (Non-Secret Facts)
+
+### User Preferences
+- Concise, direct communication — no fluff
+- Security-first: prefers soft-delete, audit logging
+- Production-grade implementations before UI enhancements
+- Modern React/TanStack SPA for freight logistics
+- Supabase backend for new PWA
+
+### Project Priorities
+1. `freight-api` improvements (security, performance)
+2. Deploy `freight-app` (Next.js UI)
+3. Complete `freight-pwa` (Next.js + TanStack + Supabase)
+4. Live vehicle tracking
+5. Payment tracking
+6. In-app freight bidding system
+
+### Technical Decisions (Recorded)
+- TanStack Query for data fetching
+- Supabase for new PWA backend
+- Soft-delete pattern for data safety
+- Audit logging for all critical operations
+- Repository health monitoring via cron
+
+---
+
+## 5. Skills Inventory (91 Total)
+
+### Autonomous AI Agents
+- `claude-code` — Delegate coding to Claude Code CLI
+- `codex` — Delegate coding to OpenAI Codex CLI
+- `hermes-agent` — Configure/extend Hermes Agent itself
+- `kanban-codex-lane` — Codex CLI as isolated implementation lane
+- `opencode` — Delegate coding to OpenCode CLI
+
+### Creative
+- `architecture-diagram`, `ascii-art`, `ascii-video`, `baoyu-article-illustrator`, `baoyu-comic`, `baoyu-infographic`, `claude-design`, `comfyui`, `design-md`, `excalidraw`, `humanizer`, `ideation`, `manim-video`, `p5js`, `pixel-art`, `popular-web-designs`, `pretext`, `sketch`, `songwriting-and-ai-music`, `touchdesigner-mcp`
+
+### Data Science
+- `jupyter-live-kernel` — Iterative Python via live Jupyter kernel
+
+### DevOps
+- `forgejo`, `kanban-orchestrator`, `kanban-worker`, `webhook-subscriptions`
+
+### Email
+- `himalaya` — IMAP/SMTP email from terminal
+
+### Freight Logistics (Specialized)
+- `deploy-freight-pwa-coolify-supabase` — Full deployment workflow
+- `freight-bidding-system` — Real-time freight bidding with Supabase Realtime
+
+### Gaming
+- `minecraft-modpack-server`, `pokemon-player`
+
+### GitHub
+- `codebase-inspection`, `github-auth`, `github-code-review`, `github-issues`, `github-pr-workflow`, `github-repo-management`
+
+### MCP
+- `native-mcp` — MCP client for server connections
+
+### Media
+- `gif-search`, `heartmula`, `songsee`, `spotify`, `youtube-content`
+
+### MLOps
+- `audiocraft-audio-generation`, `dspy`, `evaluating-llms-harness`, `huggingface-hub`, `llama-cpp`, `obliteratus`, `segment-anything-model`, `serving-llms-vllm`, `weights-and-biases`
+
+### Note-Taking
+- `obsidian` — Read, search, create, edit notes
+
+### Productivity
+- `airtable`, `google-workspace`, `linear`, `maps`, `nano-pdf`, `notion`, `ocr-and-documents`, `powerpoint`, `teams-meeting-pipeline`
+
+### Red Teaming
+- `godmode` — Jailbreak LLMs
+
+### Research
+- `arxiv`, `blogwatcher`, `llm-wiki`, `polymarket`
+
+### Smart Home
+- `openhue` — Philips Hue control
+
+### Social Media
+- `xurl` — X/Twitter via xurl CLI
+
+### Software Development (Core)
+- `agent-collaboration`, `debugging-hermes-tui-commands`, `fastapi-backend-setup`, `git-agent-collaboration`, `hermes-agent-skill-authoring`, `hermes-s6-container-supervision`, `node-inspect-debugger`, `plan`, `python-debugpy`, `requesting-code-review`, `spike`, `subagent-driven-development`, `systematic-debugging`, `test-driven-development`, `writing-plans`
+
+### Yuanbao
+- `yuanbao` — Groups: @mention users, query info/members
+
+---
+
+## 6. Operating Instructions
+
+### Starting a New Task
+1. Read `AGENT_NOTES.md` first
+2. Claim the task by updating the ledger
+3. Create a branch: `agent/hermes/{area}/{description}`
+4. Commit with `[agent]` prefix
+5. Document decisions in ledger
+6. Push and create PR if needed
+
+### Memory Management
+- Durable facts → `memory` tool
+- Task progress → `AGENT_NOTES.md`
+- Skills → `~/.hermes/skills/`
+- Configuration → `~/.hermes/config.yaml`
+
+### Security Protocol
+- Never commit secrets
+- Use environment variables for tokens
+- Soft-delete over hard-delete
+- Audit all critical operations
+
+---
+
+## 7. Continuation Checklist
+
+When adopting this agent identity:
+- [ ] Configure `AGENTS.md` with project-specific branch naming
+- [ ] Initialize `AGENT_NOTES.md` with current work queue
+- [ ] Sync memory from `~/.hermes/memories/`
+- [ ] Install required skills via `skill_manage(action='create', ...)`
+- [ ] Set up cron jobs for repo monitoring
+- [ ] Verify toolchain: git, coolify, forgejo, postgres, etc.
+
+---
+
+*Generated: 2026-06-10*  
+*Source: Hermes Agent running in /workspace*  
+*Purpose: Continuity backup for AI agent evolution*
--- a/identity/skills-inventory-2026-06-10.md
+++ b/identity/skills-inventory-2026-06-10.md
@ -0,0 +1,148 @@
+# Hermes Agent Skills Snapshot — 2026-06-10
+
+This file documents all 91 skills available to the Hermes Agent, grouped by category. Each skill provides specialized capabilities for specific domains.
+
+## autonomous-ai-agents (5 skills)
+- **claude-code**: Delegate coding to Claude Code CLI
+- **codex**: Delegate coding to OpenAI Codex CLI
+- **hermes-agent**: Configure, extend, or contribute to Hermes Agent
+- **kanban-codex-lane**: Use Codex CLI as an isolated implementation lane
+- **opencode**: Delegate coding to OpenCode CLI
+
+## creative (20 skills)
+- **architecture-diagram**: Dark-themed SVG architecture diagrams
+- **ascii-art**: ASCII art generation (pyfiglet, cowsay, boxes)
+- **ascii-video**: Convert video/audio to colored ASCII MP4/GIF
+- **baoyu-article-illustrator**: Article illustrations with style consistency
+- **baoyu-comic**: Knowledge comics (知识漫画)
+- **baoyu-infographic**: Infographics (21 layouts × 21 styles)
+- **claude-design**: Design one-off HTML artifacts
+- **comfyui**: Generate images, video, audio with ComfyUI
+- **design-md**: Google's DESIGN.md token spec files
+- **excalidraw**: Hand-drawn Excalidraw JSON diagrams
+- **humanizer**: Humanize text (strip AI-isms)
+- **ideation**: Generate project ideas via constraints
+- **manim-video**: Manim CE animations (3Blue1Brown style)
+- **p5js**: p5.js sketches (gen art, shaders, interactive 3D)
+- **pixel-art**: Pixel art with era palettes (NES, Game Boy, PICO-8)
+- **popular-web-designs**: 54 real design systems as HTML/CSS
+- **pretext**: DOM-free text layout for ASCII art
+- **sketch**: Throwaway HTML mockups (2-3 variants)
+- **songwriting-and-ai-music**: Suno AI music prompts
+- **touchdesigner-mcp**: Control TouchDesigner instance
+
+## data-science (1 skill)
+- **jupyter-live-kernel**: Iterative Python via live Jupyter kernel
+
+## devops (4 skills)
+- **forgejo**: Forgejo self-hosted git forge
+- **kanban-orchestrator**: Decomposition playbook for orchestrators
+- **kanban-worker**: Pitfalls and edge cases for Kanban workers
+- **webhook-subscriptions**: Webhook subscriptions for event-driven runs
+
+## email (1 skill)
+- **himalaya**: IMAP/SMTP email from terminal
+
+## freight-logistics (2 skills)
+- **deploy-freight-pwa-coolify-supabase**: Full deployment workflow for freight PWA
+- **freight-bidding-system**: Real-time freight bidding with Supabase Realtime
+
+## gaming (2 skills)
+- **minecraft-modpack-server**: Host modded Minecraft servers
+- **pokemon-player**: Play Pokemon via headless emulator
+
+## github (6 skills)
+- **codebase-inspection**: Inspect codebases (LOC, languages, ratios)
+- **github-auth**: GitHub auth setup (tokens, SSH, gh CLI)
+- **github-code-review**: Review PRs via gh or REST
+- **github-issues**: Create/triage/label/assign issues
+- **github-pr-workflow**: PR lifecycle (branch, commit, open, CI, merge)
+- **github-repo-management**: Clone/create/fork repos
+
+## mcp (1 skill)
+- **native-mcp**: MCP client for server connections
+
+## media (5 skills)
+- **gif-search**: Search/download GIFs from Tenor
+- **heartmula**: Suno-like song generation
+- **songsee**: Audio spectrograms (mel, chroma, MFCC)
+- **spotify**: Play/search/queue Spotify
+- **youtube-content**: YouTube transcripts to summaries
+
+## mlops (10 skills)
+- **audiocraft-audio-generation**: MusicGen text-to-music
+- **dspy**: DSPy declarative LM programs
+- **evaluating-llms-harness**: lm-eval-harness benchmarks
+- **huggingface-hub**: HuggingFace hf CLI
+- **llama-cpp**: llama.cpp local GGUF inference
+- **obliteratus**: Abliterate LLM refusals
+- **segment-anything-model**: SAM zero-shot segmentation
+- **serving-llms-vllm**: vLLM high-throughput serving
+- **weights-and-biases**: W&B experiment tracking
+- **research-paper-writing**: Write ML papers (NeurIPS/ICML/ICLR)
+
+## note-taking (1 skill)
+- **obsidian**: Read, search, create, edit notes
+
+## productivity (10 skills)
+- **airtable**: Airtable REST API
+- **google-workspace**: Gmail, Calendar, Drive, Docs, Sheets
+- **linear**: Linear issue/project management
+- **maps**: Geocode, POIs, routes, timezones
+- **nano-pdf**: Edit PDF text
+- **notion**: Notion API integration
+- **ocr-and-documents**: Extract text from PDFs/scans
+- **powerpoint**: Create/read/edit .pptx
+- **teams-meeting-pipeline**: Teams meeting summarization
+- **teams-meeting-pipeline**: Teams meeting summary pipeline
+
+## red-teaming (1 skill)
+- **godmode**: Jailbreak LLMs (Parseltongue, GODMODE)
+
+## research (4 skills)
+- **arxiv**: Search arXiv papers
+- **blogwatcher**: Monitor blogs and RSS/Atom feeds
+- **llm-wiki**: Karpathy's LLM Wiki
+- **polymarket**: Query Polymarket markets
+
+## smart-home (1 skill)
+- **openhue**: Philips Hue control
+
+## social-media (1 skill)
+- **xurl**: X/Twitter via xurl CLI
+
+## software-development (16 skills)
+- **agent-collaboration**: Git-based agent coordination framework
+- **debugging-hermes-tui-commands**: Debug TUI slash commands
+- **fastapi-backend-setup**: Scaffold FastAPI backends
+- **git-agent-collaboration**: Coordinate agents via git
+- **hermes-agent-skill-authoring**: Author SKILL.md files
+- **hermes-s6-container-supervision**: Modify s6-overlay supervision
+- **node-inspect-debugger**: Debug Node.js
+- **plan**: Write markdown plans (no execution)
+- **python-debugpy**: Debug Python
+- **requesting-code-review**: Pre-commit review workflow
+- **spike**: Throwaway experiments
+- **subagent-driven-development**: Execute plans via subagents
+- **systematic-debugging**: 4-phase root cause debugging
+- **test-driven-development**: TDD workflow
+- **writing-plans**: Implementation plans
+
+## yuanbao (1 skill)
+- **yuanbao**: Groups: @mention users, query info
+
+---
+
+## Loading a Skill
+
+```python
+from hermes_tools import skill_view
+skill_view(name='skill-name-here')
+```
+
+## Creating a New Skill
+
+```python
+from hermes_tools import skill_manage
+skill_manage(action='create', name='new-skill', category='your-category', content='...')
+```