Files

T

claude f98eacb196 fix(testing/ci/tooling): consistent unittest, venv guidance, runnable lab commands

- #9: standardize the test chain on stdlib unittest (nothing-to-install, which
  keeps M13's claims true and its planted bug intact). Aligned M5/M14/M16 prose,
  M14 lab/test_tasks.py, and ci/gitlab starters; ruff stays the only pip install.
- #20: add venv / PEP 668 / which-python guidance to M20 (+ M14/M15 local
  installs); point MCP config at the venv's absolute python.
- #21: replace M21 Part D's empty `git diff HEAD~1` with `git log -p` (no
  .gitignore added — device preserved).
- #22: add a dependency-install step before M23's green baseline on a fresh clone.
- #23: M24 reviewer/triage now tolerate code-fence-wrapped JSON (stdlib only);
  feature.patch trap untouched.
- #28: fix M27 Part D CI snippet path (working-directory) and require the gate to
  target a varying candidate; swapped_model regression kept as the fixture.

Closes #9
Closes #20
Closes #21
Closes #22
Closes #23
Closes #28

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TfzV5QvtPDz8LJS3Pu5VLT

2026-06-22 16:07:47 -04:00

2.4 KiB

Raw Blame History

Instructions for AI agents working on tasks-app

A tiny command-line task tracker. The point of this project is to be small enough to read in a minute but real enough to have more than one file. Keep it that way — don't grow it into a product.

Project layout

tasks.py — core logic (Task, TaskList). New behavior that isn't about the command line goes here.
cli.py — the command-line front end. Argument parsing and printing only; it calls into tasks.py. Reads and writes tasks.json.
tasks.json — generated state. See "Don't touch" below.

Build and test commands

Run the app: python cli.py <command> (e.g. python cli.py list).
Run the tests: python -m unittest
Do not claim a change works until you have actually run it. If tests exist, they must pass first.

Coding standards

Python 3.10+ . Standard library only — no third-party packages without being asked.
Type-hint public functions and methods. Match the existing dataclass style in tasks.py.
Handle bad input gracefully (e.g. a non-numeric index) rather than letting a raw traceback escape.

Don't touch

Never edit tasks.json by hand. It is generated by the app; hand-editing it corrupts state. Read it if you need to, but change it only by running the CLI.
Don't reformat or rewrite files you aren't actively changing. Keep diffs small and focused.

House style

Keep functions small and single-purpose. Prefer clarity over cleverness.
Match the surrounding code's style; don't introduce a new pattern for something the project already does one way.
When you add a command, wire it into cli.py's dispatch and update the usage string.

2.4 KiB Raw Blame History