objective-complete

Objective completion instructions ==================================

Follow these steps when all tasks for an objective are complete:

1. Create a completion log file for each completed objective.

- Navigate to docs/process/completion-logs/. - Create a new file named YYYY-MM-DD-objective-name.md (e.g., 2025-10-04-project-documentation.md). - Use lowercase with hyphens for the objective name portion.

1. Document what was completed in the log.

- Start with a heading using the full objective statement. - Include a "Tasks completed" section with the checkbox list from active-tasks.md. - Mark all checkboxes as complete to show the final state. - Add a "Date completed" field at the top for quick reference.

1. Capture learnings and reflections.

- Add a "Learnings" section documenting key discoveries or insights. - Include technical decisions made, approaches that worked well, or challenges encountered. - Copy relevant content from the "Working notes" section of active-tasks.md. - Add a "Reflections" section for process observations, what to do differently, or improvements. - Keep both sections concise but substantive; future you will thank you.

1. Handle new work identified during completion.

- Review working notes and reflections for newly identified work. - For well-defined new objectives: - Add them to the "To do" table in backlog.md. - Include objective statement, description, readiness, and priority. - For ideas needing more thought: - Add them to the "Parking lot" section in backlog.md. - Include open questions or concerns that need resolution.

1. Update the "Done" section in backlog.md.

- Add a new row to the "Done" table for each completed objective. - Copy the objective statement to the first column. - Link to the completion log file in the second column using relative path. - Example: [2025-10-04](./completion-logs/2025-10-04-project-documentation.md)

1. Reset the "Doing" section in backlog.md.

- Remove completed objective(s) from the "Doing" bullet list. - If no objectives remain active, leave the section with just the reference link. - Update the introductory sentence if needed to reflect current state.

1. Reset active-tasks.md for new work.

- Remove all completed objective sections and their tasks. - Clear the "Working notes" section (content should now be in completion logs). - Keep the document structure and instructions at the top. - Leave the file ready for the next objective breakdown.

1. Review and reflect on the backlog.

- After completion, take a moment to review the "To do" section. - Consider if priorities or readiness have changed based on what was learned. - Update the backlog table if needed to reflect new understanding. - This is a natural checkpoint to reassess direction.

1. Update any related documentation.

- If the completed objective impacted project documentation, update those files. - If any of your learnings are broadly applicable, consider adding them to the [Project brief].

[Project brief]: /docs/project-brief.md