Agent Operational Guidance (AGENTS.md)

This document provides critical context and operational mandates for AI agents working on the EVE Online Automated Wiki project. Read this first in case of context loss.

1. Core Architectural Mandates

1.1 Dual-Repository Strategy

The project is strictly separated into two repositories:

eve-wiki-system (Current Workspace): Contains the "Engine" (Python code, LangGraph agents, clients, infrastructure configs).
eve-wiki-content (Data Repo): Contains the "Content" (Markdown files and images).
Mandate: Agents must NEVER commit code to the content repo or content to the system repo. The git_sync_node in src/main.py is the only authorized pathway for moving data into the content repo.

1.2 Single Source of Truth (SSOT)

Git is the SSOT. Wiki.js is a renderer that pulls from the eve-wiki-content repository.
Human editing is disabled in Wiki.js. All updates must flow through the agent pipeline to maintain data integrity.

2. Source Extraction Protocols

EVE University: Use the MediaWiki API (api.php). Avoid HTML scraping.
WCKG (wckg.net): Requires real-browser rendering (Google Sites). Use the browser_agent for extractions or implement a headless browser (Playwright/Selenium). Standard httpx requests will return 404s.
CCP Support: Requires browser-like headers to bypass Cloudflare protection.

3. Implementation Standards

Environment: Use uv for all dependency management and execution.
Secrets: All keys (Wiki.js API, Gitea tokens) are stored in .env. Never commit this file.
Orchestration: Use LangGraph for the pipeline. The state model is defined in src/schema/state.py.
Validation: Content MUST meet a 95% confidence score to be published. Numerical (ESI) and Structural (Markdown) checks are "Must Pass" (failure sets total score to 0%).

4. Infrastructure Map

Component	URL / Target
Wiki Primary	`https://eve.tar.nz`
Wiki API	`https://eve.tar.nz/graphql`
Git Server	`git.local.ben.io` (SSH)
Target Server	`local.ben.io` (SSH alias: `docker-test`)
Stack Name	`eve-wiki` (Postgres, Redis, Wiki.js)

5. Resuming Work

To resume implementation, always check .private/ROADMAP.md for the current phase and task status.

2.3 KiB Raw Blame History