Engineering & Technology

The architecture decision you don’t write down is the one
you’ll argue about in six months

Projan is the teammate who knows what an RFC, an ADR or a postmortem actually needs and asks the question before it becomes an incident.

14-day free trial. No credit card required.

A WORKED EXAMPLE

A real engineering decision, captured

Watch an API refactor get scoped honestly. Two services depend on the old contract, the team has half a plan for the rollback, and nobody has mapped the downstream consumers. Projan doesn’t make the call - it asks what’s actually being decided, what the alternatives were, and what happens when the migration fails.

By the end the team has an ADR with context, decision, consequences and alternatives, a phased rollout with a rollback story, and the downstream owners flagged for review. The decisions are theirs. The structure is Projan’s.

WHAT PROJAN BRINGS

Engineering & Technology

Pushes for the decision, not just the discussion.

Engineering chat goes in circles. Projan asks what’s actually being decided, what the alternatives were, and why this one - so the ADR writes itself and the rationale survives the next person.

Surfaces the failure mode early.

Rollback story, blast radius, the dependency nobody mapped. Projan asks the operational questions before the migration, not during the outage.

Keeps the postmortem blameless and useful.

Timeline, contributing factors, action items with owners. Projan structures the incident review so it produces change, not just a document nobody reads.

WHAT YOU CAN PLAN

Document types this specialist covers

Every artefact an engineering team actually ships.

RFCs ADRs Technical design docs Incident postmortems Migration plans API designs SLO / reliability docs Threat models Runbooks

THE CONTEXT GUIDE

What you bring. What Projan brings.

The conversation is sharper when the constraints and the alternatives are explicit from the start.

What to bring to the conversation

  • The problem or decision in front of you - a performance issue, a refactor, a new service, a migration
  • The Slack threads or PR discussions where the team has been hashing it out
  • Existing architecture docs, ADRs, or system diagrams from Confluence, Notion or the repo
  • The constraints: SLAs, deadlines, on-call capacity, downstream consumers, compliance requirements
  • The alternatives you’ve considered and why you’re leaning where you are
  • Who owns the affected systems and who needs to review the decision

What Projan brings

  • Questions that force the trade-off into the open - what you’re optimising for, what you’re giving up
  • Pattern recognition on the operational gaps engineers skip under deadline (rollback, observability, contract testing, blast radius)
  • A structure that matches how engineers actually consume RFCs and ADRs - context, decision, consequences, alternatives
  • Awareness of the dependency chains and downstream consumers that turn a clean migration into a Friday incident
  • Direct export to Jira, Linear, GitHub or Azure DevOps as tickets with the rationale attached

WITHOUT PROJAN

What engineering teams get wrong without Projan

The decision got made in a thread, half the team missed it, and the rationale lived in one engineer’s head. Six months later they’ve left, the context is gone, and the team is re-litigating a choice nobody can explain. Architecture decisions that aren’t written down don’t disappear - they come back as arguments, or as incidents. Projan’s job is to capture the decision and the why while the thinking is still fresh.

Decisions that survive the next engineer. Written by your team.

Projan helps your team write the RFC, the ADR, the postmortem. Your team owns it. The result is a record engineering can actually act on and rationale that outlives the people who set it.

14-day free trial. No credit card required.

See pricing