Step 1 · Test the Project

Goal

Verify that the project is properly set up and all existing tests pass.

Instructions

You are now in workflow mode. Your goal is to test the project thoroughly and populate TODO.md with any issues found.

Tasks to perform

1. Run the test suite

  • Find and execute all unit tests.
  • Check for any failing tests.
  • Document any test failures.

2. Verify build process

  • Check if the project builds successfully.
  • Identify any build errors or warnings.

3. Check dependencies

  • Verify all dependencies are installed.
  • Look for outdated or conflicting dependencies.

4. Populate TODO.md

  • Create tasks in TODO.md for any issues found.
  • Use the format: - [ ] fix: description of the issue _(ref: workflows/dev-cycle/01-test-the-project.md)_
  • Prioritize critical issues first.
  • Status rules: [ ] = not started · [~] = in progress (one at a time) · [x] = done (prefix the date)

Expected Output

After completing this workflow step, TODO.md should contain:

  • Any test failures that need to be fixed.
  • Build errors or warnings to address.
  • Dependency issues to resolve.

If no issues are found, add a single task:

- [ ] verify: All tests passing, ready to proceed to next workflow step _(ref: workflows/dev-cycle/01-test-the-project.md)_

Example TODO.md output

## Todo
- [ ] fix: User authentication test failing on line 45 _(ref: workflows/dev-cycle/01-test-the-project.md)_
- [ ] fix: Build warning about deprecated function in utils.php _(ref: workflows/dev-cycle/01-test-the-project.md)_
- [ ] update: Laravel framework to version 11.x _(ref: workflows/dev-cycle/01-test-the-project.md)_

Exit Criteria

This workflow step is complete when:

  • All tests have been run.
  • TODO.md has been populated with actionable tasks.
  • You have committed any changes made during testing.