https://github.com/irarainey/human-first-engineering

A framework that keeps humans at the centre of software engineering — setting out the principles, behaviours, and practices that ensure engineers grow their craft in an AI-enabled world, protecting both individuals and the talent pipeline the industry depends on.
https://github.com/irarainey/human-first-engineering

ai-tools engineering-culture framework manifesto software-craftsmanship software-engineering

Last synced: about 2 months ago
JSON representation

A framework that keeps humans at the centre of software engineering — setting out the principles, behaviours, and practices that ensure engineers grow their craft in an AI-enabled world, protecting both individuals and the talent pipeline the industry depends on.

• Host: GitHub
• URL: https://github.com/irarainey/human-first-engineering
• Owner: irarainey
• License: other
• Created: 2026-04-19T10:01:34.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2026-04-19T13:24:16.000Z (about 2 months ago)
• Last Synced: 2026-04-19T13:33:10.473Z (about 2 months ago)
• Topics: ai-tools, engineering-culture, framework, manifesto, software-craftsmanship, software-engineering
• Language: Markdown
• Homepage: https://humanfirstengineering.dev
• Size: 46.9 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# Human-First Engineering

**Growing engineers in the age of AI.**

Software engineering has always been a human endeavour. The skill, the judgement, and the craft live with the people doing it — and tooling, for every previous generation, has supported that rather than replaced it. AI is powerful enough to change that equation.

Where previous tools automated the tedious work, new AI-powered tools can automate the parts engineers actually learn from — reading code carefully, working through a bug, drafting a solution and realising it is wrong. Those moments of friction are how engineers build the intuition they rely on later. Automate them at scale and you produce a generation of engineers who can assemble systems without ever building the mental models behind them, and you quietly erode the pipeline from junior to senior to principal.

That risk falls most heavily on the people entering the industry today: the visible tasks juniors traditionally learned from — small units of code, mechanical bugs, first drafts — are precisely the ones AI now does fastest. The opportunity to struggle, and to grow from that struggle, has to be protected deliberately. It will not happen by default.

Human-First Engineering is a deliberate response: a short statement of what we believe, a five-pillar framework for how we work, and a practical toolkit for embedding both in a team or organisation. The goal is to define new ways of working with these tools that keep the skill and craft of software engineers intact, so we stay in control of the engineering and do not deskill a generation in the process.

The site is published at [humanfirstengineering.dev](https://humanfirstengineering.dev). This repository contains the source.

## 📚 Contents

### 📜 Core documents

- [The Manifesto](manifesto.md) — what we believe, and why.

- [The Framework](framework.md) — the five pillars and the behaviours that bring them to life.

### 🧰 Toolkit

- [Toolkit overview](toolkit/index.md) — entry point and suggested reading order.

- [Implementation Guide](toolkit/implementation-guide.md) — step-by-step plan for introducing and embedding the framework in a team.

- [Practices](toolkit/practices.md) — concrete day-to-day patterns for using AI tools well, aligned with Microsoft's Hyper-Velocity Engineering.

- [Slide Deck](toolkit/slide-deck.md) — a ready-to-present Markdown deck for a 30–45 minute team session.

- [Developer FAQ](toolkit/developer-faq.md) — the questions engineers actually ask.

- [For Early-Career Engineers](toolkit/for-early-career-engineers.md) — practical habits for junior engineers, written for them directly.

- [Relationship to HVE](toolkit/relationship-to-hve.md) — how Human-First Engineering complements Microsoft's Hyper-Velocity Engineering.

### 📁 Project files

- [Changelog](CHANGELOG.md) — version history.

- [License](LICENSE.md) — CC BY-NC-SA 4.0.

## ✨ The one-line summary

> Think first. Own what you ship. Grow through AI, not around it. Use AI intelligently. Verify everything.

## ⚖️ License

This work is licensed under CC BY-NC-SA 4.0. Share freely. Build on it. Don't sell it. See [LICENSE](LICENSE.md) for details.