CONTRIBUTING_AI.md

Contributing with AI Assistance

What to optimize for

• correctness first
• minimal, reviewable diffs
• stable interfaces
• tests that prove the change
• documentation that matches the code

Before you edit

• inspect the owning module
• trace the data flow and error flow
• confirm the target command for validation
• decide whether the change belongs in code, docs, or both

After you edit

• run the smallest relevant test set
• run the workspace validation commands when behavior changes
• update the skill docs if boundary rules or collaboration rules changed

Repository conventions

• apps/lotus-explorer/docs/skills/*.md contains plain skill contracts.
• apps/lotus-explorer/docs/skills/SUGGESTIONS.md is reserved for non-normative improvement notes.
• AI_AGENT_GUIDE.md at the repository root is the entry point for autonomous work.