AlexandrAI AGENTS.md
agents-md

Thinklogi Agent Roster and Goal Policy Agent Guide

Agent guide for harness agent roles, first goal metrics, and guardrails.

AGENTS.md

Guidance for coding agents working on Thinklogi Agent Roster and Goal Policy in the thinklogi project.

Project overview

This guide covers harness/agents.mjs and harness/goals.mjs. The harness defines role agents for product, UX, engineering, data, moderation, security, growth, and evaluation, then seeds the first measurable goal for the mobile decision-feed MVP.

Primary source files

  • harness/agents.mjs defines the agent roster and missions.
  • harness/goals.mjs defines createFirstGoal, success metrics, guardrails, and next-goal policy.
  • harness/orchestrator.mjs assigns tasks to owners from the roster.
  • public/app.js renders the public agent snapshot.

Setup commands

npm run harness:init npm run harness:tick npm run harness:run npm test npm run build npm run dev

Change rules

  • Keep role names stable if existing task owners refer to them.
  • Add guardrails to goals when a role can generate risky product changes.
  • Keep success metrics measurable.
  • Keep the next-goal policy tied to evidence review, not arbitrary cycle count.
  • Do not expose unrestricted comments as part of the MVP without changing moderation guardrails and tests.

Testing

Cover first goal creation, active goal status, measurable metric presence, guardrail presence, agent roster names, and orchestrator task owner consistency.

PR checklist

  • Agent missions remain concrete and non-overlapping.
  • Goal metrics can be evaluated by evidence.
  • npm test and npm run harness:status pass.