Onboarding draft — for director + HR/legal review. Nothing here is yet implemented as policy.

Welcome to the AI-Oriented SDLC at Techies.

We're evolving how we build software — from writing every line by hand to directing AI agents with intent, judgment, and ownership. This is your map for that shift, and how we'll grow together from software engineers into AI engineers.

Start onboarding ↓ Jump to how KPIs work
Built on Claude Code + GitHub 4 KPI categories Measurement that coaches, not ranks-to-fire
The Vision

Why we're making this shift

AI doesn't replace engineers — it raises the floor on what one engineer can ship and the bar on the judgment that matters. Our objective is to grow every software engineer here into an AI engineer. Accountability and measurement exist to support that growth, not to rank people toward the exit. A few principles are non-negotiable — read them first, because everything else follows.

🎯

Outcomes over activity

What you ship — merged PRs, working software in GitHub — is the source of truth, not how busy you looked.

⚖️

A score is an input, not a verdict

No metric or system ever auto-triggers an employment action. A human always reviews and decides.

🚫

No vanity metrics

Lines of code, commit counts, hours logged, and raw AI-usage volume are banned as targets — full stop.

🔍

Monitoring is disclosed & proportionate

Any telemetry is metadata, never screen content, keystrokes, or Claude's responses. You always know what's measured.

🛟

Fair process before any exit

Observe → coach → formal notice → PIP with real support → human review. HR/legal gates are mandatory.

📐

Targets are calibrated defaults

Weights and targets are tuned against a 4-week baseline plus a bias check before any score counts.

The Shift

What changes day to day

Same mission, new leverage. The mechanics of how you spend your hours change — but your ownership of correctness, architecture, and outcomes only goes up.

Traditional SDLC

Hand-built, line by line

  • Write most code manually; velocity bounded by typing & boilerplate
  • Context lives in your head; knowledge stays siloed
  • Reviews catch issues late in the cycle
  • Progress often proxied by output volume
  • Tooling assists; you do the assembly
AI-Oriented SDLC

Direct the agent, own the result

  • Brief Claude Code to draft, refactor, and test; you steer with intent
  • Specs & prompts become shared, reviewable artifacts
  • You spend time on architecture, edge cases, and verification
  • Progress measured by quality outcomes shipped & AI leverage
  • AI handles the boilerplate; you guarantee the correctness
Tools & Setup

The stack everything is built on

Two tools carry the AI-oriented SDLC: Claude Code for AI-assisted development, and GitHub as the single source of truth for what you ship.

Claude Code

Anthropic's agentic coding CLI — your pair for drafting, refactoring, debugging, and testing directly in your project.

  1. Install Claude Code in your dev environment
  2. Authenticate with the Techies Team plan
  3. Run it inside a real repo and give it a task
  4. Review, verify, and commit what you accept

GitHub

The centralized record of output across all repos. Every KPI category reads from here, by author — so your work is captured fairly and consistently.

  1. Confirm commits & PRs are authored under your account
  2. Keep work in PRs with clear descriptions
  3. Let CI run — pass rates and reliability are team signals
  4. Outcomes accrue automatically; no manual logging
The New Workflow

Your day, and your week

From the ground up: what you do each day building with Claude Code, and what happens every Friday. Accountability lives in GitHub; the weekly profile is a fast, honest self-check — coaching, never a verdict.

Start / End Automated Your step Decision

The daily loop — what you actually do

Repeat through the day. The work lands in GitHub; the KPI agent logs metadata passively in the background.

Each working day Build with Claude Codeopen a repo · pick real work Prompt & orchestrateclear goal + constraints · direct the agent Verify, commit & open PRGitHub is your source of truth repeat through the day Logged automatically — in the backgroundKPI agent: app-category time + your redacted prompts (metadata only)

The weekly rhythm — every Friday

Two views come together: your GitHub output (technical) and your /weekly-kpi self-profile (human).

Every Friday technical human Your GitHub workcommits · PRs · reviews · CI Weekly auditClaude Code · /weekly-audit Metrics storethe technical view (GitHub) Run /weekly-kpiin Claude Code · about 3 min Local profileevidence stays on your machine Submit metrics6 stages + 2 notes · the human view Scoring & weekly pulsenormalize + weight · technical + human Scorecard + bandweekly pulse Gap orflag? yes no Flag for reviewcoaching conversation Manager reviewa human decides — never automatic Into monthly composite

Weekly Pulse

A fast 3-category pulse focused on coaching. Lightweight self-report plus the auto-pulled metrics — meant to spark a conversation, not to judge.

Monthly Composite

The full four-category composite, plus a trend adjustment (±5) and a small qualitative input (≤5). This is the considered view a manager reviews.

KPI Criteria & Process

How we measure — in one picture

Performance rolls up from four categories into a single 0–100 score, capped at 100 and normalized so higher always means better. Here's the whole model at a glance.

How We Measure the AI-Oriented SDLC

Outcomes over activity — a score is an input, never a verdict.

30%
Code Quality
Maintainable, correct, reviewed
25%
Productivity & Velocity
Healthy flow & cycle time
25%
Delivery & Reliability
DORA-style, mostly team-level
20%
AI Adoption
Effective AI leverage
Scoring bands — normalized 0–100, capped at 100
Needs Attention
Developing
Meets
Exceeds
0607590100
Needs attention < 60 Developing 60–74 Meets 75–89 Exceeds 90–100
Disclosed, proportionate monitoring A human always decides No LOC, commit counts, or hours as targets Calibrated on a 4-week baseline
Install

Install the KPI agent on your Mac

A small, disclosed helper for company MacBooks. It records two metadata signals for the AI-adoption picture — time per app category, and your own Claude Code prompts (redacted on-device). One-time setup, then it runs quietly in the background. You stay in control, and it never touches screen content, keystrokes, or Claude's responses.

Four steps, one time — no Terminal needed

IT delivers the app; you open it once and acknowledge.

  1. Get the app. IT/MDM installs TechiesKPIAgent.app into /Applications (or you drag the signed, notarized build there yourself).
  2. Open it once. It appears as the orange Techies mark in your menu bar — there is no Dock icon and no window. (On a notched Mac, ⌘-drag your menu-bar icons to reveal it if it's tucked behind the notch.)
  3. Read the disclosure, then click “Acknowledge & enable”. This is your consent — nothing is collected until you click it.
  4. Done — it self-installs. A background helper registers itself to start automatically at every login. Nothing else to do.

🔄 Runs automatically in the background

After you acknowledge once, the agent launches on its own at every login and relaunches itself if it ever stops — you never have to open it again. Closing the menu-bar window does not stop collection; only Pause or Stop collecting & uninstall do.

What it records

Metadata only

  • Time per app category (IDE, Terminal, Browser, Comms…) — app name only
  • Your own Claude Code prompts, after on-device secret/PII redaction
  • Active days & timestamps
What it never touches

Off-limits by design

  • Screen content or screenshots
  • Window or tab titles
  • Keystrokes
  • Claude's responses
  • File contents

⏸ Pause anytime

From the menu bar: pause for 1 hour / 4 hours / until tomorrow with a short reason. Capture fully stops and auto-resumes. Pauses are logged as neutral context — never a score.

🗑 Stop & uninstall

One click — “Stop collecting & uninstall” — removes the background helper and deletes the local queue. Fully reversible; just re-acknowledge to start again.

Disclosed & consent-gated Redacted, metadata-level Stored locally, owner-only Context for coaching, never a verdict 90-day retention
Plugin

Install the /weekly-kpi plugin in Claude Code

Each Friday you generate your own AI-Engineer Transformation Profile — an honest read on how your AI-engineering is growing. The plugin derives it from your own Claude Code history on your machine and submits only the metrics (six 0–5 stages + two short notes). Your prompt text never leaves your laptop.

📖 Full plugin guide — marketplace, install, updates, and the manager commands: KPI-Plugins.html.

✅ Before you start — what you need

  • Claude Code, signed in on the Techies Team plan.
  • Membership in the TechiesApp GitHub org — that's what makes the private plugin marketplace visible to you. (If /plugin marketplace add can't find it, you're not in the org yet — see “If something doesn't work” below.)
  • Your submit token from P&C — the TECHIES_KPI_TOKEN you set in step 2.

Add the marketplace, install, set your token — once

Two slash commands in Claude Code, then one environment variable.

  1. Add the Techies marketplace & install. In Claude Code, run:
    /plugin marketplace add TechiesApp/techies-kpi-plugin /plugin install techies-kpi@techies
  2. Set your submit token (one time). P&C gives you a token out-of-band. Add it to your shell profile (e.g. ~/.zshrc):
    export TECHIES_KPI_TOKEN="…the token P&C gave you…"
    Then open a new terminal. Never commit or paste this token into code.
  3. Run it every Friday. Type /weekly-kpi. It reads your week, scores six dimensions, saves a local my-ai-profile-<date>.html you keep, and submits just the metrics.
  4. Update later with /plugin update techies-kpi when P&C ships a new version.

🔒 Metrics only — your prompts stay local

The plugin submits your email, the week, an overall stage, six integer stages (adoption, intent, prompting_orchestration, workflow_tooling, hygiene, leverage) and two one-line notes. It never sends your prompt text, file contents, or the evidence quotes — those live only in the local HTML you generate.

🛟 If something doesn't work

  • /plugin marketplace add says “not found” or permission denied → your GitHub account isn't in the TechiesApp org yet. Ask P&C to add you, then retry.
  • /weekly-kpi fails with “TECHIES_KPI_TOKEN is not set” → you skipped step 2, or your terminal was opened before you set it. Set the token and open a new terminal.
  • Submit returns “401 / bad signature” → the token value is off. Re-copy it from P&C exactly, with no surrounding quotes or spaces.
Self-generated each Friday Metrics only, no prompt text Coaching, never a verdict Pairs with the GitHub KPI rubric
Get Started

Your first week

Work through these in order. Your progress is saved in this browser, so you can come back to it anytime.

0 / 8 done