Book Blueprint

This blueprint records the editorial intent of Tools: A Reference to the Templates, Software and Methods of The Transformed Architecture for European Enterprises and Public Authorities, a companion to The Transformed Architecture. The authoritative design is DISPOSITION.md; the chapter briefs below are generated from scripts/outline_data.py and data/tool_inventory.jsonl by scripts/generate_outlines.py.

Part I: The Toolbox

Chapter 1: Introduction: A Toolbox for the Series

  • File: 01_introduction.md
  • Status: draft
  • Purpose: Define what a tool is in the series, state the book's rules and give each reader a path through the catalogue.
  • Draws on: Book 1, Book 2, Book 3, Book 4, Book 5, Book 6, Book 7, Book 8, Book 9, Book 10
  • Inventory: no inventoried entries
  • Questions: What counts as a tool, and what does not? How is the book organised and how should each kind of reader use it?
  • Planned sections: Four kinds of tool; How the book was compiled; How to read an entry; Nordvik Region and Hansa Mutual; Summary
  • Worked example: A reader finds, in ten minutes, the tools that her next incident review needs.
  • Figure: The four kinds of tool and the eight activities of the toolbox

Chapter 2: The Anatomy of a Tool: Kinds, Identifiers and Lifecycle

  • File: 02_the_anatomy_of_a_tool.md
  • Status: draft
  • Purpose: Describe the anatomy that every entry shares: purpose, inputs, outputs, identifier family, owner, evidence age and review date.
  • Draws on: Book 1, Book 2, Book 3, Book 6, Book 10
  • Inventory: no inventoried entries
  • Questions: What do the identifier families (SVC-, DLG-, MND-, RoE- and the rest) have in common? What is the lifecycle of a tool from first use to retirement?
  • Planned sections: The common anatomy; Identifier families and how they link; Evidence age on every tool; Tools in version control; Summary
  • Worked example: Tracing one service record to the delegation profile, the observer manifest and the restore test that refer to it.
  • Figure: How the identifier families link across the books

Chapter 3: Choosing, Adopting and Retiring Tools

  • File: 03_choosing_adopting_and_retiring_tools.md
  • Status: draft
  • Purpose: Give a procedure for choosing, adopting and retiring tools, with the evidence each step needs.
  • Draws on: Book 1, Book 2, Book 3, Book 10
  • Inventory: 24 artefacts, 22 methods, 9 third-party tools and standards
  • Questions: How does an organisation choose between a template, a product and a method? What proves that a tool is adopted and still works?
  • Planned sections: Selecting; Adoption and the diffusion of tools; Maintenance and review; Retirement and exit; Anti-patterns; Summary
  • Worked example: Adoption roadmap for a policy engine at Nordvik Region.
  • Figure: Tool lifecycle with decision points

Part II: Architecture and Delivery

Chapter 4: Architecture and Decision Tools

  • File: 04_architecture_and_decision_tools.md
  • Status: draft
  • Purpose: Collect the tools for modelling architecture, recording decisions and documenting as code.
  • Draws on: Book 1, Book 2, Book 3, Book 6
  • Inventory: 22 artefacts, 12 methods, 7 own tools, 29 third-party tools and standards
  • Questions: Which tools describe architecture so that it can be versioned, reviewed and tested? Which records carry the reasons for a decision?
  • Planned sections: Architecture modelling; Architecture and decision records; Documentation, requirements and knowledge as code; Across the usage modes; Summary
  • Worked example: An ADR and a C4 model reviewed in the same pull request.
  • Figure: From model to decision record

Chapter 5: Policy, Pipeline and Evidence Tools

  • File: 05_policy_pipeline_and_evidence_tools.md
  • Status: draft
  • Purpose: Collect the tools that express policy as code, run pipelines and produce evidence.
  • Draws on: Book 1, Book 2, Book 3, Book 4, Book 6, Book 10
  • Inventory: 84 artefacts, 28 methods, 3 own tools, 54 third-party tools and standards
  • Questions: Which tools turn a rule into a check that runs on every change? Which tools produce the evidence an auditor can verify?
  • Planned sections: Policy engines and rules; Pipelines and testing; Supply-chain tools: provenance, signing, bills of materials; Evidence manifests; Across the usage modes; Summary
  • Worked example: A pipeline gate that rejects an unsigned model artefact.
  • Figure: Policy, pipeline and evidence chain

Chapter 6: Platform and Infrastructure Tools

  • File: 06_platform_and_infrastructure_tools.md
  • Status: draft
  • Purpose: Collect the platform and infrastructure tools: infrastructure as code, containers, MLOps, model serving, retrieval and gateways.
  • Draws on: Book 1, Book 3, Book 10
  • Inventory: 33 artefacts, 3 methods, 33 third-party tools and standards
  • Questions: Which tools build and run the AI platform? Which choices are open standards and which are products?
  • Planned sections: Infrastructure as code; Container and service-mesh platforms; MLOps and model serving; Retrieval and data tools; Gateways; Summary
  • Worked example: Platform baseline for a regional AI platform.
  • Figure: Layers of the AI platform and their tools

Part III: Governing AI

Chapter 7: Inventory, Classification and Risk Tools

  • File: 07_inventory_classification_and_risk_tools.md
  • Status: draft
  • Purpose: Collect the tools that inventory AI use, classify it and manage its risk.
  • Draws on: Book 2, Book 3, Book 4, Book 7, Book 10
  • Inventory: 57 artefacts, 22 methods, 3 third-party tools and standards
  • Questions: Which registers and records does a governed organisation keep? How is an exception or an impact assessment recorded?
  • Planned sections: Inventory and intake; Classification; Risk and impact assessment; AI Decision Records; Summary
  • Worked example: An intake record that classifies a use case as high-risk.
  • Figure: From intake to decision record

Chapter 8: Obligation, Assurance and Maturity Tools

  • File: 08_obligation_assurance_and_maturity_tools.md
  • Status: draft
  • Purpose: Collect the tools that map obligations, provide assurance and assess maturity.
  • Draws on: Book 1, Book 2, Book 3, Book 8, Book 10
  • Inventory: 65 artefacts, 29 methods, 1 own tools, 37 third-party tools and standards
  • Questions: Which tools map an obligation to a control and a piece of evidence? Which tools measure maturity and what do they omit?
  • Planned sections: Obligation mapping; Assurance and audit evidence; Maturity models and radar tools; Reporting and transparency; Summary
  • Worked example: A control mapping row linking one control to three frameworks.
  • Figure: Assure once, comply many

Chapter 9: Supplier, Contract and Sovereignty Tools

  • File: 09_supplier_contract_and_sovereignty_tools.md
  • Status: draft
  • Purpose: Collect the tools for procurement, contracts, sovereignty and exit.
  • Draws on: Book 2, Book 3, Book 4, Book 10
  • Inventory: 21 artefacts, 8 methods, 5 third-party tools and standards
  • Questions: Which clauses, questionnaires and registers does procurement of AI need? How is exit tested?
  • Planned sections: Procurement; Contract clauses; Sovereignty assessment; Exit and concentration; Summary
  • Worked example: A sovereignty assessment of a model provider.
  • Figure: Supplier lifecycle with exit test

Part IV: Securing and Testing

Chapter 10: Threat Modelling and Adversary Frameworks

  • File: 10_threat_modelling_and_adversary_frameworks.md
  • Status: draft
  • Purpose: Collect the frameworks and methods for modelling threats to AI systems and to the organisation.
  • Draws on: Book 1, Book 3, Book 4, Book 5, Book 6, Book 8, Book 9
  • Inventory: 4 artefacts, 5 methods, 44 third-party tools and standards
  • Questions: Which frameworks describe adversary behaviour at the right level? Which methods turn a threat model into tests?
  • Planned sections: Adversary frameworks; Threat modelling methods; Lists of AI security risks; Threat registers; Summary
  • Worked example: A threat model for a retrieval-augmented assistant.
  • Figure: From framework to threat model to test

Chapter 11: AI Red Teaming and Emulation Tools

  • File: 11_ai_red_teaming_and_emulation_tools.md
  • Status: draft
  • Purpose: Collect the tools for AI red teaming and adversary emulation, defensive and authorised only.
  • Draws on: Book 3, Book 4, Book 6, Book 8, Book 9
  • Inventory: 8 artefacts, 10 methods, 7 third-party tools and standards
  • Questions: What must a rules-of-engagement manifest contain? Which tools evaluate AI systems under authorised test?
  • Planned sections: Rules of engagement; Emulation plans; Evaluation and red-team harnesses; Reporting findings; Summary
  • Worked example: A rules-of-engagement manifest for a contracted test.
  • Figure: Authorised test from scope to finding

Chapter 12: Detection, Investigation and Intelligence Tools

  • File: 12_detection_investigation_and_intelligence_tools.md
  • Status: draft
  • Purpose: Collect the tools for detection engineering, investigation, hunting and intelligence.
  • Draws on: Book 4, Book 6, Book 8, Book 9
  • Inventory: 38 artefacts, 21 methods, 39 third-party tools and standards
  • Questions: Which formats and records carry a detection from idea to retirement? How is an AI-assisted investigation recorded?
  • Planned sections: Detection records and rules; Case and playbook records; Hunt records; Intelligence and vulnerability data; Across the usage modes; Summary
  • Worked example: A detection record with test cases and a retirement date.
  • Figure: Detection lifecycle

Chapter 13: Response, Recovery and Resilience Tools

  • File: 13_response_recovery_and_resilience_tools.md
  • Status: draft
  • Purpose: Collect the tools for incident response, recovery and resilience.
  • Draws on: Book 3, Book 4, Book 5, Book 8, Book 9, Book 10
  • Inventory: 29 artefacts, 25 methods, 10 third-party tools and standards
  • Questions: Which records carry an incident from detection to review? How is recovery proved and how old is the proof?
  • Planned sections: Incident records and reporting clocks; Recovery plans and restore tests; Post-incident review; Resilience registers; Summary
  • Worked example: A restore test whose result is two years old.
  • Figure: Incident to review to retest

Chapter 14: The Verification Loop: Purple, Chaos and Coverage Tools

  • File: 14_the_verification_loop.md
  • Status: draft
  • Purpose: Collect the tools of the verification loop: purple sessions, coverage records, regression cases and security chaos engineering.
  • Draws on: Book 1, Book 4, Book 9
  • Inventory: 21 artefacts, 21 methods, 9 third-party tools and standards
  • Questions: What makes a coverage claim evidence rather than assertion? How is independence between tester and tested kept?
  • Planned sections: Purple sessions; Coverage and evidence age; Regression cases; Security chaos engineering; Summary
  • Worked example: A coverage record with evidence age.
  • Figure: The purple loop and its five stages

Part V: Operating

Chapter 15: Observability and Service Objective Tools

  • File: 15_observability_and_service_objective_tools.md
  • Status: draft
  • Purpose: Collect the tools for observability and service objectives.
  • Draws on: Book 2, Book 3, Book 10
  • Inventory: 12 artefacts, 16 methods, 1 own tools, 14 third-party tools and standards
  • Questions: How are objectives, alerts and error budgets recorded? How does AI correlation stay within a noise budget?
  • Planned sections: Telemetry and standards; Service level objective records; Alerting and burn rates; Correlation policy and noise budget; Measurement; Summary
  • Worked example: A service level objective record with burn-rate alerts.
  • Figure: From telemetry to page

Chapter 16: Change, Restore and Runbook Tools

  • File: 16_change_restore_and_runbook_tools.md
  • Status: draft
  • Purpose: Collect the tools for change, restoration and runbooks.
  • Draws on: Book 1, Book 3, Book 10
  • Inventory: 19 artefacts, 21 methods, 12 third-party tools and standards
  • Questions: How is a change classified, frozen and rolled back? How is a runbook made executable and reviewable?
  • Planned sections: Change classes and records; Progressive delivery and GitOps; Runbooks and remediation; Freezes and windows; Summary
  • Worked example: A runbook manifest executed at Level 3.
  • Figure: Change to restore with stop path

Chapter 17: Capacity, Cost and Energy Tools

  • File: 17_capacity_cost_and_energy_tools.md
  • Status: draft
  • Purpose: Collect the tools for capacity, cost and energy.
  • Draws on: Book 1, Book 2, Book 3, Book 10
  • Inventory: 14 artefacts, 5 methods, 12 third-party tools and standards
  • Questions: Which records steer the cost of AI services? How is energy accounted for?
  • Planned sections: Cost management and FinOps; Capacity records; Token and GPU economics; Energy and carbon; Summary
  • Worked example: A consumption forecast with a budget alert.
  • Figure: Cost steering loop

Part VI: Agents and Autonomy

Chapter 18: Mandate, Delegation and Autonomy Tools

  • File: 18_mandate_delegation_and_autonomy_tools.md
  • Status: draft
  • Purpose: Collect the tools that bound what an agent may do: mandates, delegation profiles, autonomy levels and budgets.
  • Draws on: Book 2, Book 3, Book 6, Book 7, Book 8, Book 10
  • Inventory: 39 artefacts, 24 methods, 1 own tools, 12 third-party tools and standards
  • Questions: What does a mandate manifest contain? How is an autonomy level raised or lowered?
  • Planned sections: Mandate manifests; Delegation profiles; Autonomy budgets; Promotion and demotion; Across the degrees of delegation; Summary
  • Worked example: A delegation profile for an operations agent.
  • Figure: Mandate, delegation and budget

Chapter 19: Observer, Stop Path and Evaluation Tools

  • File: 19_observer_stop_path_and_evaluation_tools.md
  • Status: draft
  • Purpose: Collect the tools that verify agents independently: observers, stop paths, seeded faults and evaluations.
  • Draws on: Book 4, Book 6, Book 9, Book 10
  • Inventory: 23 artefacts, 25 methods, 2 third-party tools and standards
  • Questions: What must be independent of what it verifies? Where does the stop path run?
  • Planned sections: Observer manifests; Seeded faults; Stop paths and drills; Agent evaluation; Summary
  • Worked example: An observer manifest and a seeded fault.
  • Figure: Observer principle

Chapter 20: Defending the Agent: Identity, Credential and Protocol Tools

  • File: 20_defending_the_agent.md
  • Status: draft
  • Purpose: Collect the tools that secure the agent itself: identity, credentials, protocols, containment and tier-0 controls.
  • Draws on: Book 3, Book 4, Book 6, Book 7, Book 8, Book 10
  • Inventory: 29 artefacts, 9 methods, 20 third-party tools and standards
  • Questions: Which identity and protocol standards do agents rely on? Which controls make the operator's AI tier 0?
  • Planned sections: Agent identity and workload identity; Credentials and secrets; Agent protocols; Containment and permission manifests; Summary
  • Worked example: A permission manifest for a coding agent.
  • Figure: Agent identity and containment

Part VII: People, Organisation and Society

Chapter 21: Role, Competence and Career Tools

  • File: 21_role_competence_and_career_tools.md
  • Status: draft
  • Purpose: Collect the tools for roles, competence and careers.
  • Draws on: Book 1, Book 2, Book 6, Book 8, Book 9, Book 10
  • Inventory: 31 artefacts, 14 methods, 7 third-party tools and standards
  • Questions: How is a role charter written and reviewed? How is competence recorded without scoring people?
  • Planned sections: Role charters; Competence records; Learning paths and training; Keeping the craft; Summary
  • Worked example: A role charter and a competence record for a conductor role.
  • Figure: Role, competence and career

Chapter 22: Tools for Managing People with AI: Decision, Contestation and Care

  • File: 22_tools_for_managing_people_with_ai.md
  • Status: draft
  • Purpose: Collect the tools for the governance of AI that manages people: decision, delegation, contestation and care.
  • Draws on: Book 2, Book 7
  • Inventory: 22 artefacts, 11 methods
  • Questions: Which records give a named human decider? How is a decision contested?
  • Planned sections: Management decision records; Contestation and appeal; Impact tests with representatives; Care and wellbeing; Summary
  • Worked example: A contestation record and an appeal path.
  • Figure: Decision, contestation and appeal

Chapter 23: Tools for Weighing Evidence: Threat Registers, Debate and Foresight

  • File: 23_tools_for_weighing_evidence.md
  • Status: draft
  • Purpose: Collect the tools for weighing evidence about threats and the future: evidence ladder, threat register, constructive debate and the three outlook labels.
  • Draws on: Book 2, Book 5, Book 8, Book 9, Book 10
  • Inventory: 20 artefacts, 24 methods, 3 third-party tools and standards
  • Questions: How is a claim graded? How is a debate staged so that it ends in an action?
  • Planned sections: The evidence ladder; Threat registers; Constructive debate in four steps; Observable, expected, speculation; Summary
  • Worked example: A threat register entry graded on the evidence ladder.
  • Figure: Evidence ladder and debate

Part VIII: Experience and Conclusions

Chapter 24: Building a Toolbox: Nordvik Region and Hansa Mutual

  • File: 24_building_a_toolbox.md
  • Status: draft
  • Purpose: Show how Nordvik Region and Hansa Mutual build and run their toolboxes.
  • Draws on: Book 2, Book 3, Book 4, Book 10
  • Inventory: no inventoried entries
  • Questions: Which tools do the two organisations adopt first, and why? Where do they differ?
  • Planned sections: Nordvik Region; Hansa Mutual; Compared; Summary
  • Worked example: A year of tool adoption at the two organisations.
  • Figure: Adoption sequence at the two organisations

Chapter 25: Conclusions: One Toolbox for the Series

  • File: 25_conclusion.md
  • Status: draft
  • Purpose: Draw the book's own conclusions about the toolbox of the series.
  • Draws on: Book 1, Book 2, Book 3, Book 4, Book 5, Book 6, Book 7, Book 8, Book 9, Book 10
  • Inventory: no inventoried entries
  • Questions: What does the toolbox show about the series? What gaps remain?
  • Planned sections: What the toolbox shows; Gaps and inconsistencies found; What to do on Monday; Summary
  • Worked example: A gap list for the editor of each earlier volume.
  • Figure: Toolbox on one page