Saltar a contenido

Month 9-Week 3: Track final push (part 2) + writeup draft

Week summary

  • Goal: Finish track project to v0.5 (presentable v1-RC). Begin the substantial Q3-closing post.
  • Time: ~9 h over 3 sessions.
  • Output: Track project polished; long-form post drafted.

Why this week matters

Polish is what separates "another GitHub repo" from "a presentable artifact." The Q3-closing post is also where the year's specialty fully crystallizes.

Prerequisites

  • M09-W01 + W02 complete.
  • Session A-Tue/Wed evening (~3 h): feature freeze + tests + docs
  • Session B-Sat morning (~4 h): writeup outline + draft
  • Session C-Sun afternoon (~2 h): incumbent re-read + writeup polish

Session A-Feature freeze, tests, docs

Goal: Stop adding features. Add tests. Write docs.

Part 1-Feature freeze (15 min)

Make a decision: no more new features for the rest of the month. Move all open ideas to BACKLOG.md.

Part 2-Tests (90 min)

For each major surface in your project, add at least one test. CI should run them on push.

For evals projects: snapshot tests on a tiny golden set. For agent projects: a unit test that the tool-use loop terminates and returns expected shape. For inference projects: a benchmark test that runs in <60s and verifies throughput within a band.

Part 3-Docs (75 min)

Add or polish: - README quickstart that works on a fresh clone. - Examples directory with 1-2 runnable examples. - API reference (auto-generated is fine-mkdocs or just clear docstrings). - DESIGN.md updated with current state.

Output of Session A

  • Tests added; CI green.
  • Docs presentable.

Session B-Q3-closing post: outline + draft

Goal: Outline and draft a 3000-word substantive post.

Part 1-Outline (45 min)

1. Hook (250 w)
2. The problem and the niche (400 w)
3. The approach (700 w)-design choices, code snippets
4. Comparison vs incumbent (600 w)-table from M07-W03
5. What I learned (500 w)-about the specialty itself
6. Honest gaps (300 w)-what doesn't work yet
7. What's next (250 w)-Q4 capstone

Part 2-Draft (180 min)

Write. Use real numbers, code, and charts. The audience is practitioners in your specialty, not novices-pitch accordingly.

Part 3-Save + sleep on it (15 min)

Don't publish today. Sleep on it; edit Sunday.

Output of Session B

  • Drafted post.

Session C-Read incumbents' source + polish

Goal: Re-read source from a respected incumbent. Refine your post with insights.

Part 1-Source-reading (75 min)

Re-read: - Track A: Inspect AI's solver/scorer source. - Track B: AutoGen orchestration code or LangGraph state machines. - Track C: vLLM scheduler or SGLang's RadixAttention.

What did they do differently from your project? What's better in theirs? What's better in yours?

Add a "what these projects do better" honesty paragraph to your post.

Part 2-Edit pass (30 min)

Read aloud. Tighten.

Part 3-Push v0.5.0 (15 min)

Tag. Update CHANGELOG.

Output of Session C

  • Polished post.
  • v0.5.0 tagged.

End-of-week artifact

  • Track project at v0.5 with tests + docs
  • Q3-closing post drafted (~3000 words)
  • Source-reading notes from incumbents

End-of-week self-assessment

  • My track project would survive a code review by someone in the specialty.
  • My post is honest about what's working and what isn't.
  • I can articulate my niche in 30 seconds.

Common failure modes for this week

  • Continued feature creep. No. Freeze. Polish.
  • Defensive post tone. Honest is more credible.
  • Skipping the source re-reading. It's where the post's depth comes from.

What's next (preview of M09-W04)

Publish the Q3-closing post + Q4 capstone planning + Q3 retro + profile updates.

Comments