🚀 AI-Enhanced Software Engineering Workflow Guide

Hướng Dẫn Quy Trình Kỹ Thuật Phần Mềm Hỗ Trợ AI

English | Tiếng Việt

From weeks to days: How AI transforms the software engineering rhythm without changing the fundamentals

Từ tuần xuống ngày: Cách AI biến đổi nhịp độ kỹ thuật phần mềm mà không thay đổi nền tảng

English

📋 Table of Contents

1. Introduction
2. The Unchanged Engineering Rhythm
3. Traditional Engineering Process
4. AI-Enhanced Process
   • Feature Development Workflow
   • Understanding Existing Code
5. When to Use MCP
6. Why I Built ai-devkit
7. Real-World Example
8. The Future of AI-Enhanced Engineering
9. Getting Started

🎯 Introduction

Every Software Engineer follows a similar rhythm:

Requirements → Design → Planning → Implementation → Review → Testing → Deployment → Monitoring

This hasn't changed for a long time. What changes with AI is the velocity.

Before AI, a typical cycle for medium-sized features would take weeks. Each step involved handoffs, context switching, and waiting for feedback. With tools like Cursor and Claude Code, the same process runs significantly faster.

After experimenting with this new way of working for an extended period, I decided to turn my setup into a reusable toolkit called ai-devkit to share with others and create a consistent AI-friendly workflow across projects.

🔄 The Unchanged Engineering Rhythm

The core engineering steps remain the same:

| Phase | Activity | |-------|----------| | Requirements | Understand what needs to be built | | Design | Plan the architecture and approach | | Planning | Break down into tasks and milestones | | Implementation | Write the code | | Review | Ensure quality and maintainability | | Testing | Validate functionality | | Deployment | Ship to production | | Monitoring | Track performance and issues |

What AI changes: The speed at which you move through these phases and the consistency of execution.

🛠️ Traditional Engineering Process

Whether you work at a startup or a large tech company, the core process looks like this:

1️⃣ Understanding Requirements

• Read PRD or ticket
• Clarify what's being asked
• Output: Understanding of the problem

2️⃣ Requirements Review

• Identify gaps, edge cases, or unclear assumptions
• Output: Clarified requirements

3️⃣ Design

• Sketch architecture, data models, or API contracts
• Output: Design document

4️⃣ Design Review

• Discuss with colleagues or team leads
• Validate approach
• Output: Approved design

5️⃣ Planning

• Break down into tasks
• Estimate effort
• Define milestones
• Output: Task breakdown and timeline

6️⃣ Implementation

• Write code, debug, document
• Output: Working code

7️⃣ Implementation Review

• Peer review for quality and maintainability
• Output: Reviewed PR/MR

8️⃣ Testing

• Unit, integration, or E2E tests
• Output: Test coverage

9️⃣ Deployment & Monitoring

• Safe release and track metrics/logs
• Output: Production deployment

Timeline: Each phase involves waiting for human feedback or context preparation, potentially taking weeks or months for a medium-sized feature.

⚡ AI-Enhanced Process

The process doesn't fundamentally change—only how you execute it.

I use Cursor as my default editor and optimize the workflow around it (though I was a long-time Neovim user). I leverage Cursor Commands to create reusable workflows and avoid repetition.

You can create your own commands or use:

npx ai-devkit init

This scaffolds your workspace for either Cursor or Claude Code.

🎨 Feature Development Workflow

1️⃣ Understanding Requirements

Command: /new-requirement

• In Cursor AI Chat (or Claude Code), this command summarizes goals, constraints, and success criteria
• Highlights unclear points and assumptions
• Output: docs/ai/requirements/*.md

2️⃣ Requirements Review

After running /new-requirement, all documentation is in docs/ai/.

Manual Review: Stay in control of your work

Command: /review-requirement

• Cursor helps identify potential gaps in requirements
• Output: Review notes and clarifications

3️⃣ Design

When running /new-requirement, Cursor also suggests designs in docs/ai/design.

Best Practice: Create multiple design alternatives, compare trade-offs, and refine manually

Output: docs/ai/design/*.md

4️⃣ Design Review

Command: /review-design

• Cursor acts as a peer reviewer
• Challenges design decisions
• Reminds you of potential oversights
• Output: Design review feedback

5️⃣ Planning

Convert design into concrete steps and checklists.

Output: docs/ai/planning/*.md

6️⃣ Implementation

This is where AI tools like Cursor and Claude Code shine.

Command: /execute-plan

• After reviewing design and plan, this command executes tasks sequentially
• Output: Implementation code

Quality Checks:

Command: /check-implementation

• Ensures code meets requirements

Command: /code-review

• Manual review to ensure quality

7️⃣ Testing

Command: /writing-test

• Generates unit and integration tests with high coverage
• Output: Test files

8️⃣ Deployment & Monitoring

Cursor helps generate:

• Release notes
• Deployment steps
• Metrics and alerts

You still think through the steps, but AI keeps the workflow continuous, helping you stay focused on problem-solving longer.

📚 Understanding Existing Code

A large part of programming is understanding existing code. For years, this has been challenging, especially for new engineers.

AI accelerates this process by:

• Describing what code does
• Pointing out where code is used
• Explaining how parts connect

Command: /capture-knowledge

• Analyzes code from any entry point
• Creates comprehensive documentation with visual diagrams
• Output: Code understanding documentation

🔌 When to Use MCP

In Cursor or Claude Code, you don't always need to run through Model Context Protocol (MCP) servers. MCP is extremely useful for direct tool integration, but many workflows are more efficient with CLI.

✅ Use MCP when:

Example 1: Figma MCP Server

• Fetch design details directly into Cursor
• Saves time referencing components or colors

Example 2: Atlassian MCP Server

• Fetch Jira tickets or Confluence info when running /new-requirement
• Keeps requirements in sync

❌ Don't use MCP when:

Example: GitLab

• Use CLI instead of MCP server
• Fast, simple, sufficient for creating MRs
• MCP adds unnecessary complexity

Rule of thumb: Use MCP when sharing context between AI and external tools makes workflow smoother. Don't force everything through MCP—CLI and direct editor integration are often more efficient for simple tasks.

🎁 Why I Built ai-devkit

Before ai-devkit, I kept a folder of prompts. Each time I started new work, I'd:

1. Copy prompts into Cursor
2. Adjust and run them

Problems:

• ❌ Manual and time-consuming
• ❌ Inconsistent across projects
• ❌ Error-prone
• ❌ Sometimes lost context midway

Solution: Package everything into a single setup—ai-devkit

Benefits:

• ✅ Consistent across projects
• ✅ Reusable by others
• ✅ Works in Cursor or Claude Code
• ✅ Universal structure
• ✅ Maintained context

💡 Real-World Example: Better Output, Lower Cost

In a previous comparison of Claude Sonnet 4.5, GPT-5 Codex, and Grok Code Fast 1:

• Grok Code Fast 1 was fast but code was incomplete

With ai-devkit and /new-requirement using Grok Code Fast 1:

• ✅ Fast
• ✅ Good results on the first try
• ✅ Much lower cost than other models

Key Insight: The model matters, but how we provide input to the model matters more.

🚀 The Future of AI-Enhanced Engineering

AI is now part of the engineering workflow—it augments, not replaces engineers. We are empowered by it.

What stays the same:

• The engineering phases
• Clear thinking
• Responsible design
• Thorough testing

What changes:

• ⚡ Cycle time decreases
• 🔄 Less friction between steps
• 🎯 More time in flow state
• 🚀 Faster iteration

I see this as the new normal: Engineers still own the craft, but have a powerful copilot to accelerate.

🎬 Getting Started

1. Install ai-devkit:

npx ai-devkit init

2. Choose your environment:

• Cursor
• Claude Code

3. Start using commands:

• /new-requirement - Create requirements
• /review-requirement - Review requirements
• /review-design - Review designs
• /execute-plan - Implement features
• /check-implementation - Validate implementation
• /code-review - Review code quality
• /writing-test - Generate tests
• /capture-knowledge - Document existing code

4. Experiment and extend:

• Use built-in commands
• Create custom prompts
• Contribute improvements

All contributions are welcome! 🙌

📞 Connect & Contribute

• GitHub: [ai-devkit repository]
• Documentation: docs/ai/
• Issues & PRs: Welcome!

Made with ❤️ by engineers, for engineers

Built to make AI-enhanced development accessible to everyone

Tiếng Việt

📋 Mục Lục

1. Giới Thiệu
2. Nhịp Độ Kỹ Thuật Không Thay Đổi
3. Quy Trình Kỹ Thuật Truyền Thống
4. Quy Trình Hỗ Trợ AI
   • Phát Triển Tính Năng
   • Hiểu Code Hiện Có
5. Khi Nào Dùng MCP
6. Tại Sao Tôi Tạo ai-devkit
7. Ví Dụ Thực Tế
8. Tương Lai Của Kỹ Thuật Hỗ Trợ AI
9. Bắt Đầu

🎯 Giới Thiệu

Mỗi Kỹ sư Phần mềm đều theo một nhịp điệu tương tự:

Yêu Cầu → Thiết Kế → Lập Kế Hoạch → Triển Khai → Review → Kiểm Thử → Triển Khai → Giám Sát

Điều này đã không thay đổi trong một thời gian dài. Điều thay đổi với AI chính là tốc độ.

Trước khi có AI, một chu trình điển hình cho các tính năng cỡ vừa thường kéo dài vài tuần. Mỗi bước đều liên quan đến việc trao đổi, chuyển đổi bối cảnh, và chờ phản hồi. Với các công cụ như Cursor và Claude Code, cùng một quy trình nay chạy nhanh hơn đáng kể.

Sau khi thử nghiệm cách làm việc mới này trong một thời gian dài, tôi quyết định biến thiết lập của mình thành một bộ công cụ có thể tái sử dụng, gọi là ai-devkit, để chia sẻ với người khác và tạo ra quy trình làm việc hỗ trợ AI nhất quán giữa các dự án.

🔄 Nhịp Độ Kỹ Thuật Không Thay Đổi

Các bước kỹ thuật cốt lõi vẫn giữ nguyên:

| Giai Đoạn | Hoạt Động | |-----------|-----------| | Yêu Cầu | Hiểu những gì cần được xây dựng | | Thiết Kế | Lên kế hoạch kiến trúc và cách tiếp cận | | Lập Kế Hoạch | Chia nhỏ thành các nhiệm vụ và mốc quan trọng | | Triển Khai | Viết code | | Review | Đảm bảo chất lượng và khả năng bảo trì | | Kiểm Thử | Xác thực chức năng | | Triển Khai | Đưa lên production | | Giám Sát | Theo dõi hiệu suất và vấn đề |

AI thay đổi gì: Tốc độ mà bạn di chuyển qua các giai đoạn này và tính nhất quán của việc thực thi.

🛠️ Quy Trình Kỹ Thuật Truyền Thống

Dù bạn làm việc tại startup hay công ty công nghệ lớn, quy trình cốt lõi như sau:

1️⃣ Hiểu Yêu Cầu

• Đọc PRD hoặc ticket
• Làm rõ những gì được yêu cầu
• Kết quả: Hiểu về vấn đề

2️⃣ Review Yêu Cầu

• Xác định khoảng trống, các trường hợp biên hoặc giả định chưa rõ
• Kết quả: Yêu cầu được làm rõ

3️⃣ Thiết Kế

• Phác thảo kiến trúc, mô hình dữ liệu hoặc hợp đồng API
• Kết quả: Tài liệu thiết kế

4️⃣ Review Thiết Kế

• Thảo luận với đồng nghiệp hoặc trưởng nhóm
• Xác nhận cách tiếp cận
• Kết quả: Thiết kế được phê duyệt

5️⃣ Lập Kế Hoạch

• Chia thành các nhiệm vụ
• Ước lượng công sức
• Định nghĩa các mốc quan trọng
• Kết quả: Phân chia nhiệm vụ và timeline

6️⃣ Triển Khai

• Viết code, debug, viết tài liệu
• Kết quả: Code hoạt động

7️⃣ Review Triển Khai

• Peer review để đảm bảo chất lượng và khả năng bảo trì
• Kết quả: PR/MR đã được review

8️⃣ Kiểm Thử

• Unit, integration hoặc E2E tests
• Kết quả: Test coverage

9️⃣ Triển Khai & Giám Sát

• Release an toàn và theo dõi metrics/logs
• Kết quả: Triển khai production

Thời gian: Mỗi giai đoạn đều phải chờ phản hồi từ con người hoặc chuẩn bị bối cảnh, có thể mất vài tuần hoặc vài tháng cho một tính năng cỡ vừa.

⚡ Quy Trình Hỗ Trợ AI

Quy trình về cơ bản không thay đổi—chỉ khác ở cách bạn thực hiện.

Tôi sử dụng Cursor làm editor mặc định và tối ưu hóa quy trình xung quanh nó (dù trước đây tôi là người dùng Neovim lâu năm). Tôi tận dụng Cursor Commands để tạo workflow có thể tái sử dụng và tránh lặp lại.

Bạn có thể tự tạo command hoặc dùng:

npx ai-devkit init

Lệnh này sẽ scaffold workspace của bạn cho Cursor hoặc Claude Code.

🎨 Phát Triển Tính Năng

1️⃣ Hiểu Yêu Cầu

Lệnh: /new-requirement

• Trong Cursor AI Chat (hoặc Claude Code), lệnh này tóm tắt mục tiêu, ràng buộc và tiêu chí thành công
• Làm nổi bật những điểm chưa rõ và các giả định
• Kết quả: docs/ai/requirements/*.md

2️⃣ Review Yêu Cầu

Sau khi chạy /new-requirement, tất cả tài liệu đều trong docs/ai/.

Review Thủ Công: Luôn nắm bắt công việc của bạn

Lệnh: /review-requirement

• Cursor giúp xác định các khoảng trống tiềm năng trong yêu cầu
• Kết quả: Ghi chú review và làm rõ

3️⃣ Thiết Kế

Khi chạy /new-requirement, Cursor cũng gợi ý thiết kế trong docs/ai/design.

Best Practice: Tạo nhiều phương án thiết kế, so sánh trade-offs, và tinh chỉnh thủ công

Kết quả: docs/ai/design/*.md

4️⃣ Review Thiết Kế

Lệnh: /review-design

• Cursor đóng vai trò peer reviewer
• Thách thức các quyết định thiết kế
• Nhắc nhở những điều có thể bỏ qua
• Kết quả: Phản hồi review thiết kế

5️⃣ Lập Kế Hoạch

Chuyển thiết kế thành các bước cụ thể và checklist.

Kết quả: docs/ai/planning/*.md

6️⃣ Triển Khai

Đây là nơi AI như Cursor và Claude Code phát huy sức mạnh.

Lệnh: /execute-plan

• Sau khi review thiết kế và kế hoạch, lệnh này thực hiện các nhiệm vụ lần lượt
• Kết quả: Code triển khai

Kiểm Tra Chất Lượng:

Lệnh: /check-implementation

• Đảm bảo code đáp ứng yêu cầu

Lệnh: /code-review

• Review thủ công để đảm bảo chất lượng

7️⃣ Kiểm Thử

Lệnh: /writing-test

• Tạo unit và integration tests với coverage cao
• Kết quả: Các file test

8️⃣ Triển Khai & Giám Sát

Cursor giúp tạo:

• Release notes
• Các bước triển khai
• Metrics và alerts

Bạn vẫn suy nghĩ các bước, nhưng AI giữ luồng công việc liên tục, giúp bạn tập trung vào giải quyết vấn đề lâu hơn.

📚 Hiểu Code Hiện Có

Một phần lớn của việc lập trình là hiểu code đã có sẵn. Trong nhiều năm, việc này luôn khó khăn, đặc biệt với kỹ sư mới.

AI tăng tốc quá trình này bằng cách:

• Mô tả code đang làm gì
• Chỉ ra nơi code được sử dụng
• Giải thích cách các phần kết nối với nhau

Lệnh: /capture-knowledge

• Phân tích code từ bất kỳ entry point nào
• Tạo tài liệu toàn diện kèm sơ đồ trực quan
• Kết quả: Tài liệu hiểu code

🔌 Khi Nào Dùng MCP

Trong Cursor hoặc Claude Code, không phải lúc nào cũng cần chạy qua Model Context Protocol (MCP) server. MCP cực kỳ hữu ích khi cần tích hợp trực tiếp giữa các công cụ, nhưng nhiều workflow vẫn hiệu quả hơn khi dùng CLI.

✅ Dùng MCP khi:

Ví dụ 1: Figma MCP Server

• Lấy chi tiết thiết kế trực tiếp vào Cursor
• Tiết kiệm thời gian khi tham khảo component hoặc màu

Ví dụ 2: Atlassian MCP Server

• Lấy ticket Jira hoặc info Confluence khi chạy /new-requirement
• Giữ yêu cầu đồng bộ

❌ Không dùng MCP khi:

Ví dụ: GitLab

• Dùng CLI thay vì MCP server
• Nhanh, đơn giản, đủ cho việc tạo MR
• MCP thêm độ phức tạp không cần thiết

Nguyên tắc: Dùng MCP khi chia sẻ bối cảnh giữa AI và công cụ ngoài giúp workflow mượt mà. Đừng ép tất cả theo MCP—CLI và tích hợp trực tiếp với editor thường hiệu quả hơn cho các tác vụ đơn giản.

🎁 Tại Sao Tôi Tạo ai-devkit

Trước ai-devkit, tôi giữ một thư mục chứa prompts. Mỗi lần bắt đầu công việc mới, tôi:

1. Copy prompt vào Cursor
2. Chỉnh lại và chạy

Vấn đề:

• ❌ Thủ công và tốn thời gian
• ❌ Không đồng nhất giữa các dự án
• ❌ Dễ lỗi
• ❌ Đôi khi mất context giữa chừng

Giải pháp: Gói tất cả vào một setup duy nhất—ai-devkit

Lợi ích:

• ✅ Nhất quán giữa các dự án
• ✅ Người khác có thể tái sử dụng
• ✅ Hoạt động trong Cursor hoặc Claude Code
• ✅ Cấu trúc universal
• ✅ Duy trì context

💡 Ví Dụ Thực Tế: Output Tốt Hơn, Chi Phí Thấp Hơn

Trong so sánh trước đây giữa Claude Sonnet 4.5, GPT-5 Codex, và Grok Code Fast 1:

• Grok Code Fast 1 nhanh nhưng code không đầy đủ

Với ai-devkit và /new-requirement dùng Grok Code Fast 1:

• ✅ Nhanh
• ✅ Kết quả tốt ngay lần đầu
• ✅ Chi phí thấp hơn nhiều so với các model khác

Insight Quan Trọng: Model quan trọng, nhưng cách chúng ta cung cấp input cho model còn quan trọng hơn.

🚀 Tương Lai Của Kỹ Thuật Hỗ Trợ AI

AI giờ là một phần của workflow kỹ thuật—nó tăng cường, không thay thế kỹ sư. Chúng ta được tăng sức mạnh nhờ nó.

Những gì không thay đổi:

• Các giai đoạn kỹ thuật
• Tư duy rõ ràng
• Thiết kế có trách nhiệm
• Kiểm thử kỹ lưỡng

Những gì thay đổi:

• ⚡ Thời gian chu trình giảm
• 🔄 Ít cản trở giữa các bước
• 🎯 Nhiều thời gian trong trạng thái flow
• 🚀 Lặp nhanh hơn

Tôi coi đây là bình thường mới: Kỹ sư vẫn sở hữu nghề, nhưng có copilot mạnh mẽ để tăng tốc.

🎬 Bắt Đầu

1. Cài đặt ai-devkit:

npx ai-devkit init

2. Chọn môi trường của bạn:

• Cursor
• Claude Code

3. Bắt đầu dùng các lệnh:

• /new-requirement - Tạo yêu cầu
• /review-requirement - Review yêu cầu
• /review-design - Review thiết kế
• /execute-plan - Triển khai tính năng
• /check-implementation - Xác thực triển khai
• /code-review - Review chất lượng code
• /writing-test - Tạo tests
• /capture-knowledge - Tài liệu hóa code hiện có

4. Thử nghiệm và mở rộng:

• Dùng các lệnh có sẵn
• Tạo prompts tùy chỉnh
• Đóng góp cải tiến

Mọi đóng góp đều được hoan nghênh! 🙌

📞 Kết Nối & Đóng Góp

• GitHub: [ai-devkit repository]
• Tài liệu: docs/ai/
• Issues & PRs: Chào đón!

Được tạo với ❤️ bởi kỹ sư, cho kỹ sư

Xây dựng để làm cho phát triển hỗ trợ AI trở nên dễ tiếp cận với mọi người

📄 License

MIT License - Feel free to use, modify, and distribute

🙏 Acknowledgments

Special thanks to all engineers experimenting with AI-enhanced workflows and sharing their insights with the community.

⭐ Star this project if you find it helpful! ⭐

🔀 Fork and contribute to make it even better! 🔀