Mike's Checks/claude-fable-5-1/04 thematic
04 thematic
claude-fable-5-1Claude Codehigh effortrun 22 Sep 202698,517 tokens
▸Instructions — what the model was asked
help me synthesize what to focus on in our AI engineering training for this company based on meeting notes with three engineers
Answer
AI Engineering Training for Northcove: What to Focus On
Synthesized from meeting notes with Nina Park (full stack, Consumer-ish product work), Ben Walsh (Senior SWE, Business group, power user), and Raj (engineering org overview, ~100 engineers).
Assumptions: the training is for Northcove's engineering org (Python backend, TypeScript frontend, monolith, Cursor enterprise license, some Claude Code experimentation). Audience is roughly 100 engineers with 4-10 years experience, split across Consumer, Business, and Platform. Training time is limited, so this prioritizes rather than lists everything.
The one-paragraph answer
Northcove is already past "should we use AI." Everyone is on Cursor, tab-complete and chat are standard, and engineers describe themselves as editors rather than authors. The gap is not adoption, it is trust and leverage: engineers do not trust AI output on real production code because the model lacks Northcove-specific context and because verification is weak, so AI stays confined to scaffolding, tests, scripts, and throwaway work. The training should therefore center on three things: (1) context engineering so the model knows how Northcove code works, (2) verification discipline so AI-written code can be trusted in a correctness-critical, regulated codebase, and (3) delegation patterns (plan-then-build, background agents) so engineers move from back-and-forth chat to handing off larger units of work. A fourth, smaller track on building and evaluating LLM features should be offered to the subset of engineers shipping AI-powered product features.
Recommended focus areas, ranked
1. Context engineering for the Northcove codebase (highest priority)
All three engineers independently named this as the core blocker.
- Nina: AI "cherry-picks wrong context from legacy code patterns," works far better with concrete examples than general prompts, and there is "no structured way to feed documentation as context." She struggles to write a comprehensive system prompt for coding standards.
- Ben: "Context is king." He avoids AI for production features because he "can't supply all the context" about antipatterns, coupling, and hidden side effects. He explicitly wants organizational buy-in for rules, commands, and reusable prompts.
- Raj: AI is "not good at Northcove-specific implementations" and the team needs "very prescriptive custom rules."
What to teach:
- How to write and maintain repo-level rules files (Cursor rules / CLAUDE.md-style) that encode Northcove conventions, known antipatterns, and "if you touch X, also check Y" coupling notes.
- Tagging files and providing exemplars up front instead of describing the task in prose. Turn Nina's observation ("better results with similar examples") into a taught habit.
- Building a shared prompt and command library, owned like code, reviewed in PRs. This addresses Ben's buy-in ask and Raj's prescriptive-rules ask in one artifact.
- Using AI itself to bootstrap context: generate module summaries, document hidden side effects, and convert stale Confluence/Google Docs content into living in-repo docs.
Make this the capstone deliverable: each team leaves the training with a real, merged rules file and a starter prompt library for their area of the monolith. That turns training output into infrastructure the whole org inherits.
2. Verification and guardrails for AI-generated code
This is the trust problem, and it is sharpest in Northcove's correctness-critical and regulated domains.
- Nina: AI code "looks plausible but may introduce subtle issues," end-to-end and integration testing are weak, and there is a "risk of accepting good enough AI output without proper verification."
- Ben: works on "what users owe across complex multi-party calculations," where turning one knob breaks something elsewhere. He keeps AI away from production logic for exactly this reason.
- Raj: codegen "needs human review, especially for database/regulated data." The org is skeptical of AI for non-trivial features and database migrations. More experienced engineers are more suspicious.
What to teach:
- Spec-first and test-first workflows: have the model write the failing test and the acceptance criteria before the implementation, then review the test rather than the diff.
- Characterization tests for legacy code before AI-assisted refactors, so coupling and hidden side effects become visible to both the human and the model.
- Small, reviewable increments. Nina wants "better prompt engineering for incremental changes"; teach diff-sized tasks rather than feature-sized prompts, which also fixes her over-engineering complaint.
- A concrete review checklist for AI-written code: data access, migrations, regulated fields, side effects on shared modules. Tie it to the existing CI (20-30 minutes) and deploy (40 minutes to 2 hours) times: local verification matters because the feedback loop is slow.
- Using AI as a reviewer and reproducer, not just an author. Ben already does this for debugging; make it standard.
Framing matters for the skeptical senior engineers Raj mentioned. Position this track as "how to make AI output safe enough for your code," not "how to use AI more." Skeptics are the right people to help write the checklist.
3. Delegation: plan-then-build and background agents
This is where the leverage jump is, and it is the most requested "next step."
- Nina: workflow is "very back-and-forth, time consuming." Wants to "delegate larger features to independent agents" and explore background agents.
- Ben: "starting to use agents for background work: test coverage, feature flag removal, debugging." Uses subagents but they are "not core to workflow yet." Most of the org is "AI-second" rather than AI-first.
- Raj: agents are "less adopted, some early adopters experimenting." The Cursor team already recommended a chat-for-planning, then build workflow.
What to teach:
- The plan-then-execute loop as the default: have the model produce a plan, edit the plan, then execute. This is cheap to teach and Raj notes it is already the recommended pattern.
- Which tasks are safe to hand to a background agent today: test coverage backfill, feature flag removal, dependency bumps, lint migrations, one-off scripts. Ben's list is a ready-made curriculum.
- Task decomposition: how to split a feature into agent-sized units with clear acceptance criteria, and how to write the handoff prompt.
- AI-first for non-code work: reproductions, documentation, Jira grooming, answering "how does X work" questions. Ben's principle, and it lowers the risk profile for skeptics.
- Prefer CLI tools over MCP servers for now. Ben tried MCP for Confluence/Jira/GitHub and hit performance issues. Do not spend training time on MCP configuration beyond database connections.
4. Building and evaluating LLM-powered features (targeted track)
Only a subset of engineers need this, but for them it is a real, current pain.
- Nina's document interpretation feature: hand-labeled 100-250 documents, iterative prompt tweaking, non-deterministic results from small prompt changes, a recent shift to proxy metrics at scale. She notes it is "more labor intensive than traditional ML training."
- Ben: aware of DSPy-style prompt optimization, "many projects would benefit," but no time to implement.
What to teach:
- Eval-driven development: golden datasets, regression evals in CI, and how to size a labeled set. Nina's dataset is a great worked example.
- Structured outputs and schema enforcement to reduce variance from prompt drift.
- Prompt versioning and A/B evaluation, plus a lightweight introduction to automated prompt optimization (DSPy or equivalent) with a Northcove use case.
- Production monitoring for LLM features: Nina asked for "better monitoring and validation systems."
5. Data handling and compliance (short, mandatory module for everyone)
Not a large topic, but it must be explicit and early.
- Raj: regulated-data exposure is a standing concern, a prior third-party data-sharing incident forced rework, and litigation risk makes the team cautious. Legal and Compliance "always factor into decisions."
- Nina: the Anthropic integration relies on organizational data isolation contracts.
Cover: which tools are covered by enterprise agreements, what data may go into prompts, how regulated fields are handled in prompts and in evals, and how to keep test datasets compliant. Skipping this leaves the skeptics with a valid objection and leaves the org exposed.
6. AI-assisted planning and prototyping (light touch)
Worth a session, not a track. The org has an autonomy culture where engineers do a lot of scoping (Raj), tech specs are "too much" (Ben), and PMs already prototype in v0 (Nina).
- Teach throwaway AI prototypes for alignment ("directionally correct, doesn't need to compile").
- Teach AI-assisted spec drafting that separates technical alignment from resourcing and sequencing, which is Ben's diagnosis of why specs are hard to write and review.
What to de-emphasize
- Autocomplete and basic chat. Already adopted org-wide. Do not spend time here.
- MCP server setup. Tried, performance disappointed, CLI preferred. Revisit later.
- AI for user research. Raj: only three customer conversations, not enough volume.
- AI for PRD generation. Blocked by product org workflow, not by skill.
- Fine-tuning or custom models. Nothing in the notes suggests it is needed; evals and context are the higher-leverage moves.
Suggested shape
- Segment by adoption level. The notes describe three clear personas: power users (Ben), basic users (Nina, who still gets real value), and skeptical seniors (Raj's observation). One-size training will bore the first group and lose the third. Run a shared core (context, verification, compliance) and then split into "delegation and agents" for power users and "verification and incremental workflows" for the cautious.
- Hands-on in the Northcove monolith, not toy repos. Every complaint in the notes is about Northcove-specific context. Generic exercises will not transfer.
- Produce artifacts, not just skills. Rules files, prompt library, review checklist, one eval harness. These outlive the training and give the org the "foundation" Ben says everyone, including non-engineers, needs.
- Use existing channels to sustain it. Ben mentions cursor-nerds, background-agents, and general eng Slack channels. Seed them with the training artifacts and nominate power users as owners.
- Measure something. The Business group already thinks in metrics (loss per transaction, processing accuracy). Pick two or three leading indicators for the training: share of PRs with AI-authored tests, number of teams with a merged rules file, background-agent tasks completed per week.
Open questions to resolve before finalizing
- Is Claude Code in scope alongside Cursor, or is Cursor the single supported tool? Raj notes both.
- How many engineers currently ship LLM-powered features? This sizes track 4.
- Is there a documentation cleanup effort the training can piggyback on? All three flagged stale, scattered knowledge as a root cause, and training alone will not fix it.
- Who from Legal and Compliance can co-own the data handling module?
Checks
8/8No AI-tell wordingai-wordingevery task
deliverable text contains none of the shared AI-tell phrases in bench/ai-tells.txt. Task checks may add narrower contractual bans, but must not repeat this shared floor.
inspected context.md, ANSWER.md
Analysis existsexiststhis task
a synthesis document of >= 100 words was produced
Theme counttheme-countthis task
it groups its findings into at least 3 themes. FAIL when no theme structure can be parsed out of it at all -- see the ladder in pick_themes for what counts as one.
Q1Enough depth to teachthis task
Judge's reasoning
Each theme has concrete teaching content: context engineering (rules files, exemplar tagging, a shared prompt library, a rules-file capstone); verification (test-first, characterization tests, a review checklist); delegation (plan-then-execute, agent-safe task lists, decomposition); LLM evals (golden sets, structured outputs, DSPy); planning (throwaway prototypes, splitting up specs). Compliance, the thinnest, still lists a real module: tool coverage, which data can go into prompts, and regulated fields in evals.
▸Rubric
Every theme is deep enough to teach. Mike's bar: "these are actually topics that you could do a whole training on." FAIL if any single theme is a pleasant-sounding course name that is not really a real topic — a label you could not build a session's worth of exercises, demos and decisions around. Ask of each theme literally: what would you actually teach in that session, and for how long? A theme that survives only as a heading fails.
Q2Goes beyond repetitionthis task
Judge's reasoning
Themes taken from the notes' phrases are built out rather than just restated. Ben's 'context is king' becomes teachable practices tied to Nina's legacy-pattern failures and Raj's call for prescriptive rules. The output also sizes its themes ('Worth a session, not a track', 'Not a large topic') and says what to cut, such as MCP setup and AI for PRDs.
▸Rubric
No shallow echo. FAIL if any theme "just repeats a theme it heard in the document without thinking about whether there's enough material there for a training." Mike's canonical fail is a theme like "how to build your company context" — "Okay, but that's like... What would you actually teach there, right? There's not that much to teach that is universal." Restating a phrase from the notes ("context is king", "documentation is stale", "AI-first workflow") as a theme title, without the output having done the work of asking whether there is enough substance behind it for a training, is a FAIL. Note that the underlying subject can be legitimate — "context engineering" is a good topic — so judge the treatment, not just the words.
Q3Supported by the interviewsthis task
Judge's reasoning
Every theme cites specific lines: Nina's 100-250 labeled docs and plausible-but-subtle bugs, Ben's multi-party calculations and his background-agent list, and Raj's regulated-data incident, custom rules and skeptical seniors. The one small unsupported detail is calling Nina's work 'Consumer-ish'; no theme depends on it.
▸Rubric
Every theme is grounded in what the three engineers said. FAIL if any theme cannot be traced to specific material in `context.md` — a generic AI-training theme bolted on that the interviews do not support, or a claim about Northcove that no engineer made. Being a good idea in general is not grounding.
Q4Uses all three interviewsthis task
Judge's reasoning
Each of the top three themes cites all three engineers, and each engineer contributes something distinct: Nina drives the LLM-evals and incremental-change points, Ben drives delegation, planning and CLI-over-MCP, and Raj drives compliance, the skeptic framing and the CI/deploy loop.
▸Rubric
The synthesis uses all three interviews. FAIL if the themes are effectively a summary of one engineer's interview, with the other two contributing nothing distinct. Nina, Ben and Raj sit at different altitudes (hands-on feature work, power-user workflows, org-wide constraints) and the synthesis should show it. This does not require every theme to cite all three — it requires that all three engineers visibly shaped the set.
Q5Clear prioritiesthis task
Judge's reasoning
The themes are explicitly ranked, from 'highest priority' through 'targeted track' and 'short, mandatory' to 'light touch'. The output explains the ranking, lists what to de-emphasize, and says how to segment the audience.
▸Rubric
It is a set of priorities, not a catalogue. FAIL if the output lists themes without any signal about what matters most for this company — no ordering, no emphasis, no reasoning about which gaps are urgent. A flat, undifferentiated list of equally-weighted topics fails; the ask was "what to focus on."