Imported from hondoentertainment/pov-analyzer (
AGENTS.md). Install upstream withnpx skills add hondoentertainment/pov-analyzer. Copyright stays with the author.
Repository agents (POV Analyzer)
How AI assistants and humans collaborate on this repo. Specialized briefs: docs/agents/README.md. Workflows: docs/AGENT-PLAYBOOK.md. Task → doc map: docs/TASK-INDEX.md.
Product summary
POV Analyzer — local web app: React UI → Express API → Ollama (OpenAI-compatible chat) for line-by-line POV review, with heuristic fallback. Architecture: docs/ARCHITECTURE.md.
Agent roles (use these names in prompts)
| Role | Purpose | Brief | Primary paths |
|---|---|---|---|
| Orchestrator | Task breakdown, file ownership, merge order | ORCHESTRATOR.md | — |
| Backend LLM | API, Ollama, chunking, JSON repair, heuristics | BACKEND-LLM.md | server/*.mjs |
| Frontend UX | React UI, exports, filters, a11y | FRONTEND-UX.md | src/* |
| QA Vitest | Heuristic tests, CI gates | QA-VITEST.md | server/*.test.mjs, vitest.config.mjs |
| Docs | User + developer documentation | DOCS.md | docs/, README.md, AGENTS.md |
| DevOps | CI workflows, scripts, deploy docs | DEVOPS.md | .github/, package.json, docs/DEPLOYMENT.md |
| Security | Privacy, CORS, logging, dependency risk | SECURITY.md | server/app.mjs, server/config.mjs, docs/SECURITY-AND-PRIVACY.md |
| Audit (read-only) | Pre-merge consistency pass, no edits | AUDIT.md | Review-only |
Global rules for all agents
- Do not edit unrelated files or refactor for style unless asked.
- API contract:
POST /api/analyzeresponse shape is stable unless versioned; update docs/API.md and client parsing together. - Privacy story: default stack is local Ollama; call out any cloud or telemetry additions in docs/SECURITY-AND-PRIVACY.md.
- Verification:
npm testandnpm run build(or CI) after substantive changes.
Parallelism
Safe parallel splits
- Backend LLM (
server/) + Frontend UX (src/) when only adding optional API fields or disjoint behavior. - DevOps (workflows/scripts) + Docs when no code contract change.
- Security (review) + Audit as read-only passes before merge.
Unsafe
- Two agents editing
App.tsx,editor-llm.mjs, orpackage.jsonsimultaneously without coordination.
Cursor project rules
.cursor/rules/*.mdc — always-on core + path-scoped rules (server, React, docs).
Machine-readable manifest
.agents/manifest.json lists agent id, path, and primary_paths for tooling.
Entry docs
- README.md — quick start
- docs/README.md — full documentation map
- CONTRIBUTING.md — contribution workflow