From 20f68e973d32ce5a01b5c0c665689707564f163c Mon Sep 17 00:00:00 2001 From: Shiran Rubin Date: Tue, 19 Aug 2025 10:26:04 +0100 Subject: [PATCH 1/5] add have main page --- docs/HVE/README.md | 115 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 docs/HVE/README.md diff --git a/docs/HVE/README.md b/docs/HVE/README.md new file mode 100644 index 000000000..bbfde865d --- /dev/null +++ b/docs/HVE/README.md @@ -0,0 +1,115 @@ +# โšก Hypervelocity Engineering (HVE) + +**Hypervelocity Engineering (HVE)** is a modern delivery approach designed to help small, expert teams deliver +high-quality software at speed. It builds on core engineering fundamentals by embedding compliance, security, and +governance from the start, enabling rapid iteration and measurable customer impact. + +## ๐Ÿ”‘ Core Principles + +- **Multidisciplinary Expert Teams** + Small, focused crews with deep domain knowledge across engineering, design, AI, and customer domains. + +- **Production-Ready Starting Points** + Use of open-source templates and patterns that include built-in compliance, security, and governance guardrails. These + assets are curated to be โ€œeasy to find, easy to use, and easy to contribute back to.โ€ + +- **AI-Augmented Development** + Leverage AI tools to assist in coding, testing, documentation, and reviews to accelerate delivery and improve + time-to-value. + +- **Outcome-Focused Reviews** + Code is evaluated based on real-world functionality and business impact, not just syntax or style. + +- **Continuous Feedback Loops** + Daily demos and stakeholder input ensure alignment and reduce rework. + +- **Quality Embedded from Start** + Guardrails like policy-as-code, automated checks, and secure defaults enforce standards throughout the sprint. + +--- + +## ๐Ÿง  AI Agents Across the Lifecycle + +HVE teams increasingly use **AI agents** not just for coding, but for: + +- Code reviews and test authoring +- Large-scale refactoring +- Dependency upgrades +- Infrastructure setup (e.g. CI/CD pipelines, IaC templates) + +These agents enable tasks that were previously unrealistic for small teams, allowing them to start delivering value +weeks or months earlier than traditional approaches. + +> โš ๏ธ **Note**: The use of AI agents does **not eliminate the need for human review**. Human oversight remains essential +> to ensure correctness, context awareness, ethical compliance, and alignment with business goals. + +--- + +## ๐Ÿ“Š Measurable Impact from Real-World Pilots + +HVE pilots have demonstrated: + +- **75% faster time to market** +- **2.5ร— productivity gain** +- **91.8% CI/CD success rate** +- **400+ issues managed across 60+ branches** + +These results reflect the power of combining AI tooling, engineering fundamentals, and structured planning. + +--- + +## ๐Ÿงช Testing Framework for HVE + +A proposed testing framework for HVE includes: + +- Automated validation of generated architectures +- Security compliance checks +- Quality dashboards with feedback loops +- Functional accuracy scoring + +This ensures HVE-generated content meets enterprise standards without manual bottlenecks. + +--- + +## ๐Ÿ” Security in HVE Workflows + +Security guidance for HVE includes: + +- Using first-party tools (e.g. GitHub Copilot Enterprise) for sensitive IP +- Avoiding standalone AI tools for sensitive data +- Preferring secure infrastructure and prompt engineering best practices +- Aligning with policy-as-code and secure defaults from day one + +--- + +## ๐Ÿ“ˆ HVE in Data Science + +HVE principles are being applied to machine learning workflows, enabling: + +- Full-cycle automation from exploratory analysis to model evaluation +- Integration of CRISP-DM and hypothesis-driven development +- Use of LLMs as coding agents for iterative feedback and rapid prototyping + +--- + +## ๐Ÿงฐ Implementation Checklist + +| Practice | Description | +|---------------------|--------------------------------------------------------------------------| +| โœ… Templates Used | Starting points include security, compliance, and observability defaults | +| โœ… AI Tools Enabled | AI-assisted coding, testing, and documentation integrated into workflow | +| โœ… Daily Demos | Stakeholder feedback loop established with daily or frequent demos | +| โœ… Guardrails Active | Policy-as-code, automated security scans, and CI/CD checks in place | +| โœ… Outcome Reviews | Code reviews focus on business outcomes and user impact | +| โœ… OSS Contribution | Teams contribute learnings and improvements back to shared assets | + +--- + +## ๐Ÿ“š Resources + +- [Engineering Fundamentals Checklist](https://github.com/microsoft/code-with-engineering-playbook/blob/main/docs/engineering-fundamentals-checklist.md) +- [Developer Experience](https://github.com/microsoft/code-with-engineering-playbook/blob/main/docs/developer-experience/README.md) +- [Reliability Practices](https://github.com/microsoft/code-with-engineering-playbook/blob/main/docs/reliability/README.md) +- [ISE Overview](https://github.com/microsoft/code-with-engineering-playbook/blob/main/docs/ISE.md) +- [Engineering Feasibility Spikes](https://github.com/microsoft/code-with-engineering-playbook/blob/main/docs/design/design-reviews/recipes/engineering-feasibility-spikes.md) +- [Feature Request for HVE Guidelines](https://github.com/Microsoft/code-with-engineering-playbook/issues/1094) From ee6a1bea51b5a4ac8aed84bf488e1fb6dd7a52eb Mon Sep 17 00:00:00 2001 From: Shiran Rubin Date: Tue, 19 Aug 2025 13:20:25 +0100 Subject: [PATCH 2/5] fix links --- docs/HVE/README.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/HVE/README.md b/docs/HVE/README.md index bbfde865d..b69985806 100644 --- a/docs/HVE/README.md +++ b/docs/HVE/README.md @@ -107,9 +107,8 @@ HVE principles are being applied to machine learning workflows, enabling: ## ๐Ÿ“š Resources -- [Engineering Fundamentals Checklist](https://github.com/microsoft/code-with-engineering-playbook/blob/main/docs/engineering-fundamentals-checklist.md) -- [Developer Experience](https://github.com/microsoft/code-with-engineering-playbook/blob/main/docs/developer-experience/README.md) -- [Reliability Practices](https://github.com/microsoft/code-with-engineering-playbook/blob/main/docs/reliability/README.md) -- [ISE Overview](https://github.com/microsoft/code-with-engineering-playbook/blob/main/docs/ISE.md) -- [Engineering Feasibility Spikes](https://github.com/microsoft/code-with-engineering-playbook/blob/main/docs/design/design-reviews/recipes/engineering-feasibility-spikes.md) -- [Feature Request for HVE Guidelines](https://github.com/Microsoft/code-with-engineering-playbook/issues/1094) +- [Engineering Fundamentals Checklist](https://microsoft.github.io/code-with-engineering-playbook/engineering-fundamentals-checklist/) +- [Developer Experience](https://microsoft.github.io/code-with-engineering-playbook/developer-experience/) +- [Reliability Practices](https://microsoft.github.io/code-with-engineering-playbook/non-functional-requirements/reliability/) +- [ISE Overview](https://microsoft.github.io/code-with-engineering-playbook/ISE/) +- [Engineering Feasibility Spikes](https://microsoft.github.io/code-with-engineering-playbook/design/design-reviews/recipes/engineering-feasibility-spikes/) From 70bd1de274cec602a33a3f121239e52fef9f867d Mon Sep 17 00:00:00 2001 From: Shiran Rubin Date: Tue, 19 Aug 2025 17:11:24 +0100 Subject: [PATCH 3/5] Update docs/HVE/README.md Co-authored-by: Tess Ferrandez --- docs/HVE/README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/HVE/README.md b/docs/HVE/README.md index b69985806..381990a38 100644 --- a/docs/HVE/README.md +++ b/docs/HVE/README.md @@ -26,8 +26,6 @@ governance from the start, enabling rapid iteration and measurable customer impa - **Quality Embedded from Start** Guardrails like policy-as-code, automated checks, and secure defaults enforce standards throughout the sprint. ---- - ## ๐Ÿง  AI Agents Across the Lifecycle HVE teams increasingly use **AI agents** not just for coding, but for: From a6bd9184c17cdec00ae8cca7afe9e690ecd4f0c0 Mon Sep 17 00:00:00 2001 From: Shiran Rubin Date: Tue, 19 Aug 2025 17:12:20 +0100 Subject: [PATCH 4/5] Update docs/HVE/README.md --- docs/HVE/README.md | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/docs/HVE/README.md b/docs/HVE/README.md index 381990a38..b88aaa5d1 100644 --- a/docs/HVE/README.md +++ b/docs/HVE/README.md @@ -41,8 +41,6 @@ weeks or months earlier than traditional approaches. > โš ๏ธ **Note**: The use of AI agents does **not eliminate the need for human review**. Human oversight remains essential > to ensure correctness, context awareness, ethical compliance, and alignment with business goals. ---- - ## ๐Ÿ“Š Measurable Impact from Real-World Pilots HVE pilots have demonstrated: @@ -54,8 +52,6 @@ HVE pilots have demonstrated: These results reflect the power of combining AI tooling, engineering fundamentals, and structured planning. ---- - ## ๐Ÿงช Testing Framework for HVE A proposed testing framework for HVE includes: @@ -67,8 +63,6 @@ A proposed testing framework for HVE includes: This ensures HVE-generated content meets enterprise standards without manual bottlenecks. ---- - ## ๐Ÿ” Security in HVE Workflows Security guidance for HVE includes: @@ -78,8 +72,6 @@ Security guidance for HVE includes: - Preferring secure infrastructure and prompt engineering best practices - Aligning with policy-as-code and secure defaults from day one ---- - ## ๐Ÿ“ˆ HVE in Data Science HVE principles are being applied to machine learning workflows, enabling: @@ -88,8 +80,6 @@ HVE principles are being applied to machine learning workflows, enabling: - Integration of CRISP-DM and hypothesis-driven development - Use of LLMs as coding agents for iterative feedback and rapid prototyping ---- - ## ๐Ÿงฐ Implementation Checklist | Practice | Description | From 34e4040edf1b7bf2d947a5de30a08e3d3ca5bf1d Mon Sep 17 00:00:00 2001 From: Shiran Rubin Date: Tue, 19 Aug 2025 17:12:36 +0100 Subject: [PATCH 5/5] Update docs/HVE/README.md --- docs/HVE/README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/HVE/README.md b/docs/HVE/README.md index b88aaa5d1..7d739b719 100644 --- a/docs/HVE/README.md +++ b/docs/HVE/README.md @@ -91,7 +91,6 @@ HVE principles are being applied to machine learning workflows, enabling: | โœ… Outcome Reviews | Code reviews focus on business outcomes and user impact | | โœ… OSS Contribution | Teams contribute learnings and improvements back to shared assets | ---- ## ๐Ÿ“š Resources