Development Workflow & Agents

This project utilizes "Persona Agents" to automate routine tasks like documentation and deployments.

Docser Agent (Unified)

The Docser agent replaces the legacy Secretary and Saver agents. It handles the full documentation lifecycle in a single workflow.

Triggers

Trigger	Action
svch	Save current session summary to documentation/chats/history/
analyz	Analyze history, update docs, build, and deploy to remote

analyz Build Protocol

Docser always runs these steps in order to prevent stale cache/sidebar artifacts:

# 1. Clean all caches and build artifacts
cd /root/sites/vania-novikau.me/documentation && npm run clear

# 2. Regenerate llms.txt / llms-full.txt index
npm run index

# 3. Build static site
npm run build

# 4. Deploy to remote
rsync -avz -e "ssh -o StrictHostKeyChecking=no" \
  /root/sites/vania-novikau.me/documentation/build/ \
  root@<remote_host>:/var/www/html/documentation/

Note: Always use rsync without --delete is insufficient — stale remote files (e.g., old tutorial folders) persist. The current deploy command removes them via the build clean cycle.

VS Code Snippets

Defined in .vscode/project.code-snippets:

• svch: Invokes Docser save-history mode.
• analyz: Invokes Docser analyze-and-deploy mode.