By name: monorepo-workflows description: Route work to the correct service and command surface in the SynthoraAI monorepo. Use when Codex needs repository-specific guidance about which directory owns a task, which commands are canonical, which wrappers are stale, what validation to run, or which paths are generated and should not be edited.
Monorepo Workflows
Identify the owning service before changing code.
Follow This Workflow
- Map the task to
backend/,frontend/,crawler/,newsletters/,agentic_ai/,infrastructure/,shell/, orbin/. - Read the nearest
AGENTS.mdfor that directory. - Prefer root/workspace
package.jsonscripts andbin/aicc.jsover shell wrappers when both exist. - Edit source files, not generated output.
- Run the narrowest useful validation for the touched surface.
Use The References
- Read
references/service-map.mdfor ownership, commands, and known drift. - Read
references/validation-map.mdwhen the change spans multiple services.