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.