Files

T

claude fbec36cb67 feat(course): build out all 27 modules, capstone, scaffold, and conventions

Scaffold the course repo and author the full curriculum in dependency-chain
order, following the settled build decisions in handoff.md.

- Scaffold: course README, vendor-neutral AGENTS.md (dogfoods Module 5),
  _TEMPLATE.md (the fixed 9-section module shape), root .gitignore, ship config.
- Modules 1-2: reference exemplars (locked for tone/depth/lab style).
- Modules 3-27: full lessons + runnable labs, each following the template,
  respecting the chain, vendor/model-agnostic, with "feel the pain" labs.
- Module 8 hosting comparison web-researched and date-stamped (as of 2026-06-22),
  not written from memory; expansion-zone modules carry Verify-before-publish.
- Capstone: the full loop end to end on the running tasks-app example.

Lab code syntax-checked (Python/shell/YAML); every module has the 7 core
template sections.

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

2026-06-22 12:18:30 -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: pytest
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