Sailtech Engineering Playbook: Engineering Practice Guide for the AI Era

Title: Sailtech Engineering Playbook: Engineering Practice Guide for the AI Era Abstract: This is a set of engineering practice manuals for the AI-assisted development era, covering coding standards, workflow norms, automation scripts, and Agent skill definitions, providing standardized guidance for human-AI collaborative software development. Original Author/Maintainer: brayan Source Platform: GitHub Original Title: engineering-playbook Original Link: https://github.com/brayan/engineering-playbook Source Release/Update Time: 2026-05-23 Core Point: This guide is positioned as a shared, repo-neutral engineering standard center, providing unified collaboration norms for human engineers and AI agents to adapt to the paradigm shift in software engineering in the AI era.

With the rapid development of large language models and AI coding assistants, the software engineering field is undergoing a profound paradigm shift. Traditional development processes, code review methods, and team collaboration models are being redefined. Traditional engineering manuals only focus on human collaboration, while the AI-assisted development era needs to expand to the dimension of human-AI collaboration—AI agents can participate in code generation, review, documentation writing, test generation, and other links, requiring clear boundaries of human and AI responsibilities and collaboration methods. Establishing engineering practice standards adapted to the AI era has become an important issue for technical teams.

The Sailtech Engineering Playbook is positioned as a "shared, repo-neutral engineering standard center", providing a unified standard reference for personnel and AI agents within the organization. Unlike traditional project-specific documents, its architecture is designed as a reference source rather than a distribution mechanism: downstream repositories point to the central repository to obtain shared standards, and only project-specific overlays are retained locally, avoiding standard duplication and drift, and ensuring the consistency of organizational-level standards.

The Playbook defines four main audience categories:

1. Engineers seeking guidance on organizational-level engineering expectations (unified reference for new and old members);
2. Coding agents involved in development (need clear machine-parsable standards such as code style and submission format);
3. Code review reviewers (check if local guidelines comply with shared standards);
4. Cross-repo standard maintainers (unified update entry).

The repository adopts a modular organization:

• docs/: Detailed documents explaining what the standards are and why;
• scripts/: Automation scripts (code formatting, static checking, etc., which can be integrated into CI/CD or used locally);
• skills/: A featured section defining AI Agent skills (behavior patterns, tool usage, output formats);
• templates/: PR, Issue, and document templates (AI-friendly, including field descriptions and examples);
• AGENTS.md: AI Agent-specific guidance; README.md: Project entry document.

Its engineering philosophy reflects forward-looking thinking:

1. Document parseability: Standards have both natural language descriptions and machine-understandable structured representations to help AI execute accurately;
2. Responsibility division: Clearly define task types for "human decision-making" (e.g., architectural design) and "AI delegation" (e.g., code formatting);
3. Feedback loop: Continuously collect feedback on AI execution effects, iteratively improve standards, and adapt to technological development.

It has valuable reference value for teams introducing AI-assisted development:

• Learn how to define the behavioral boundaries of AI agents, design human-AI friendly document structures, establish cross-project standard sharing mechanisms, and continuously evolve standards;
• Its open-source nature allows other organizations to draw on structural concepts and customize their own manuals, promoting the improvement of engineering practice levels in the industry.

The Sailtech Engineering Playbook represents the evolution direction of engineering practice documents in the AI era and is an exploration of the new paradigm of human-AI collaboration. Through clear audience definition, clear modules, and forward-looking skill definitions, it provides a reference framework for teams. As AI capabilities enhance, such manuals will become more important—helping teams maintain code quality and standard stability while enjoying AI efficiency. It is recommended to follow this open-source project to provide guidance for AI-assisted development practices.