engineering-practices

Context-Based Exploration Guide

Use this matrix to decide which topics to explore with questions. Do not present topics that have no justification in the context.

Large scale (50+ devs)

Questions to ask:

• "With this volume of developers, how do you coordinate merges today? Have you considered trunk-based with feature flags?"
• "Is there a CODEOWNERS model or module ownership? How does it work?"
• "Are the CI gates sufficient to prevent breakage in main with so many contributors?"

Topics at play: branch strategy, CODEOWNERS, CI gate rigor.

Medium scale (10-50 devs)

Questions to ask:

• "What branch strategy do you use? Have you experienced friction with it?"
• "How many approvals do you require on PRs? Does it work well or create a bottleneck?"

Topics at play: branch strategy, level of rigor in PR reviews.

Small scale (<10 devs)

Just confirm baseline. Do not force complexity where it does not solve any real problem.

Regulated domain (fintech, healthcare, government)

Questions to ask:

• "What compliance requirements affect the pipeline? Do you need SAST, DAST, dependency scan?"
• "Is there a requirement for environment segregation or audit trail?"
• "Is IaC mandatory by policy or is it the team's choice?"

Topics at play: security gates, IaC, environment segregation, compliance gates.

Observability pain mentioned

Questions to ask:

• "Do you already have some instrumentation or are you starting from scratch?"
• "What level of observability do you need? Would centralized logs suffice, or do you need distributed tracing?"
• "Have you already chosen an observability SDK/platform, or is that decision still open?"

Topics at play: observability stack, tracing, alerts.

DevOps/CI-CD pain mentioned

Questions to ask:

• "What CI/CD platform do you use? Is the pain with the platform itself or with the pipeline?"
• "How do you deploy today? Is it manual, partially automated, or fully automated?"
• "Have you had rollback issues? Is there a defined strategy?"

Topics at play: CI/CD platform, deploy strategy, rollback.

SRE/Operations pain mentioned

Questions to ask:

• "Do you use SLOs/SLIs today? Or is operations reactive?"
• "Is there an incident management process? Runbooks?"
• "What level of operational maturity is the team aiming for?"

Topics at play: SLOs/SLIs, error budgets, runbooks, incident management.

Cloud deploy

Questions to ask:

• "Will you use IaC? Do you already have a preference between Terraform, Bicep, Pulumi?"

…

init-docs

用于初始化项目或校验并生成 SDD 文档模板，确保规范齐全且为最新版本。

subagent-driven-development

用于在当前会话中拆分并并行推进独立实现任务，加快开发执行效率。