Mandatory Documentation
Before closing the issue, instruct the agent:
Document all steps taken.
Explain:
1. Decisions made.
2. Files created.
3. Patterns used.
4. Architectural choices.
5. Potential improvements.
This documentation becomes extremely valuable.
Most organizations skip this step.
This is where much of the learning occurs.
Mini Exercise
List the documentation you would require before closing an AI-assisted issue.
Example
The issue should record:
- what was created
- why key decisions were made
- what patterns were reused
- what should become a skill or guideline