ਇੱਕ ਬੁੱਧੀਮਾਨ ਡਿਵੈਲਪਰ ਇੱਕ ਵਿਸ਼ਾਲ ਪੁੱਲ ਬੇਨਤੀ ਨੂੰ ਖੋਲ੍ਹ ਕੇ ਇੱਕ ਨਵਾਂ ਪ੍ਰੋਜੈਕਟ ਸ਼ੁਰੂ ਨਹੀਂ ਕਰਦਾ. ਉਹ ਬ੍ਰੇਨਸਟਾਰਮਿੰਗ, ਟੀਮਮੇਟ ਚਰਚਾ, ਪ੍ਰੋਟੋਟਾਈਪਿੰਗ, ਡਾਇਗ੍ਰਾਮਸ, ਪ੍ਰਸਤਾਵਾਂ, ADRs, MRs/PRs, ਅਤੇ GitOps - ਹਰ ਬਦਲਾਅ 'ਤੇ ਇੱਕ ਸਮੀਖਿਆ ਬੋਟ ਦੇ ਨਾਲ ਅੱਗੇ ਵਧਦੇ ਹਨ - ਅਤੇ, ਜਦੋਂ ਸਕੇਲ ਇਸਦੀ ਮੰਗ ਕਰਦਾ ਹੈ, ਤਾਂ ਵਰਕਸਟੇਸ਼ਨ ਦਾ ਮਲਟੀ-ਏਜੰਟ ਆਰਕੀਟੈਕਚਰ ਇੱਕ ਮਹਾਨ ਵਿਕਾਸ ਟੀਮ ਨੂੰ ਇਕੱਠਾ ਕਰਨ ਲਈ ਜੋ ਉਤਪਾਦਨ-ਗਰੇਡ ਦੇ ਕੰਮ ਨੂੰ ਤੇਜ਼ੀ ਨਾਲ ਭੇਜਦਾ ਹੈ।
1. ਨਵੇਂ ਪ੍ਰੋਜੈਕਟ 'ਤੇ "ਸਿਆਣੇ" ਦਾ ਕੀ ਮਤਲਬ ਹੈ
ਸਿਆਣਪ ਸਸਤੀ ਹੈ ਜਲਦੀ ਸਿੱਖਣਾ ਅਤੇ ਦੁਰਲੱਭ ਮਹਿੰਗੀਆਂ ਗਲਤੀਆਂ ਦੇਰ ਨਾਲ। ਹੇਠਾਂ ਦਿੱਤੇ ਕ੍ਰਮ ਨੂੰ ਕ੍ਰਮਬੱਧ ਕੀਤਾ ਗਿਆ ਹੈ ਤਾਂ ਕਿ ਹਰੇਕ ਕਦਮ ਅਗਲੇ ਦੇ ਧਮਾਕੇ ਦੇ ਘੇਰੇ ਨੂੰ ਸੁੰਗੜਦਾ ਹੈ:
Brainstorm → Discuss with workmates → Prototype → Diagram → Propose → ADR
→ Implement in small slices → MR/PR + Review Bot → Merge
→ GitOps promote (dev → staging → prod) → Observe → Iterate
Optional scale-up:
Workstation multi-agent crew (Planner / Builders / Reviewers / Ops)
with human gates on risky actions
2. ਬ੍ਰੇਨਸਟਾਰਮਿੰਗ
ਦੂਜਿਆਂ ਦਾ ਸਮਾਂ ਬਿਤਾਉਣ ਤੋਂ ਪਹਿਲਾਂ, 30-90 ਮਿੰਟ ਇਕੱਲੇ ਬਿਤਾਓ:
- ਨਤੀਜਾ - ਜਦੋਂ ਅਸੀਂ ਪੂਰਾ ਕਰ ਲੈਂਦੇ ਹਾਂ ਤਾਂ ਕਾਰੋਬਾਰ ਲਈ ਕੀ ਸੱਚ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ?
- ਪਾਬੰਦੀਆਂ - ਸਮਾਂ, ਪਾਲਣਾ, ਪਲੇਟਫਾਰਮ, ਹੁਨਰ, ਬਜਟ।
- ਗੈਰ-ਗੋਲ — ਕੀ v1 ਸਪੱਸ਼ਟ ਤੌਰ 'ਤੇ ਸ਼ਾਮਲ ਨਹੀਂ ਹੋਵੇਗਾ।
- ਖਤਰੇ - ਡੇਟਾ, ਸੁਰੱਖਿਆ, ਪ੍ਰਦਰਸ਼ਨ, ਲਾਕ-ਇਨ, ਓਪਸ ਲੋਡ।
- ਸਫਲਤਾ ਮਾਪਕ - ਦੋ ਚੁਣੋ (ਜਿਵੇਂ ਕਿ ਲੇਟੈਂਸੀ + ਗੋਦ ਲੈਣਾ, ਜਾਂ ਲਾਗਤ + ਗਲਤੀ ਦਰ)।
ਇਸ ਨੂੰ ਹੇਠਾਂ ਲਿਖੋ docs/ideas/. ਅਣਲਿਖਤ ਦਿਮਾਗੀ ਤੂਫ਼ਾਨ ਉੱਡ ਜਾਂਦੇ ਹਨ।
3. ਕੰਮ ਕਰਨ ਵਾਲੇ ਸਾਥੀਆਂ ਨਾਲ ਚਰਚਾ
ਸਭ ਤੋਂ ਛੋਟੇ ਉਪਯੋਗੀ ਸਰਕਲ ਨੂੰ ਸੱਦਾ ਦਿਓ: ਇੱਕ ਪੀਅਰ ਲਾਗੂ ਕਰਨ ਵਾਲਾ, ਇੱਕ ਨਾਲ ਲੱਗਦੇ ਸਿਸਟਮ ਦਾ ਮਾਲਕ, ਅਤੇ ਸੁਰੱਖਿਆ/SRE ਜਦੋਂ ਜੋਖਮ ਇਸਦੀ ਵਾਰੰਟੀ ਦਿੰਦਾ ਹੈ।
- ਟਾਈਮ-ਬਾਕਸ (25-45 ਮਿੰਟ)। ਫੈਸਲਿਆਂ ਜਾਂ ਖੁੱਲ੍ਹੇ ਸਵਾਲਾਂ ਨਾਲ ਸਮਾਪਤ ਕਰੋ।
- ਫੋਰਸ ਵਿਕਲਪ: ਏ ਬਨਾਮ ਬੀ ਬਨਾਮ ਮੁਲਤਵੀ - ਅਸਪਸ਼ਟ ਸਮਝੌਤਾ ਨਹੀਂ।
- ਲਿਖਾਰੀ ਨੂੰ ਸੌਂਪੋ; ਨੋਟ ਪ੍ਰਸਤਾਵ ਨੂੰ ਬੀਜਦਾ ਹੈ।
- ADR ਲਈ ਜੋਖਮਾਂ ਵਜੋਂ ਬੇਅਰਾਮੀ ਨੂੰ ਕੈਪਚਰ ਕਰੋ - ਕੋਈ ਚੁੱਪ ਵੀਟੋ ਨਹੀਂ।
Async RFCs ਠੀਕ ਹਨ ਜੇਕਰ ਕੋਈ ਲੂਪ ਬੰਦ ਕਰਦਾ ਹੈ।
4. ਪ੍ਰੋਟੋਟਾਈਪਿੰਗ
ਸਪਾਈਕ ਜਦੋਂ ਅਨਿਸ਼ਚਿਤਤਾ ਜ਼ਿਆਦਾ ਹੁੰਦੀ ਹੈ। ਬੁੱਧੀਮਾਨ ਨਿਯਮ:
- ਇਸ ਨੂੰ ਇੱਕ ਸਪਾਈਕ ਲੇਬਲ ਕਰੋ; ਇੱਕ ਕੈਲੰਡਰ ਸਟਾਪ ਸੈੱਟ ਕਰੋ (1-3 ਦਿਨ ਆਮ)।
- ਇਸ ਨੂੰ ਸੁੱਟੇ ਹੋਏ ਸ਼ਾਖਾ 'ਤੇ ਰੱਖੋ ਜਾਂ
spikes/- ਪਾਲਿਸ਼ ਨਾ ਕਰੋ. - ਜੋ ਤੁਸੀਂ ਸਿੱਖਿਆ ਹੈ ਉਸ 'ਤੇ ਦਸ ਗੋਲੀਆਂ ਲਿਖੋ (ਖਾਸ ਕਰਕੇ ਅਸਫਲਤਾਵਾਂ)।
- ਫੈਸਲਾ ਕਰੋ: ਪ੍ਰਚਾਰ ਕਰੋ, ਦੁਬਾਰਾ ਲਿਖੋ ਜਾਂ ਤਿਆਗ ਦਿਓ — ਕਦੇ ਵੀ "ਚੁੱਪ-ਚਾਪ ਉਤਪਾਦ ਨਾ ਬਣੋ।"
5. ਚਿੱਤਰ
ਤਿੰਨ ਸਕੈਚ ਆਮ ਤੌਰ 'ਤੇ ਕਾਫ਼ੀ ਹੁੰਦੇ ਹਨ:
| ਚਿੱਤਰ | ਜਵਾਬ |
|---|---|
| ਸੰਦਰਭ (C4 L1) | ਕੌਣ ਕਿਸ ਨਾਲ ਗੱਲ ਕਰਦਾ ਹੈ? ਭਰੋਸਾ ਸੀਮਾਵਾਂ? |
| ਕ੍ਰਮ | ਖੁਸ਼ਹਾਲ ਮਾਰਗ + ਇੱਕ ਅਸਫਲਤਾ ਮਾਰਗ |
| ਤੈਨਾਤੀ | ਜਿੱਥੇ ਇਹ ਚੱਲਦਾ ਹੈ; ਸੰਰਚਨਾ ਅਤੇ ਰਾਜ਼ ਦਾ ਪ੍ਰਵਾਹ |
ਪ੍ਰਸਤਾਵ ਦੇ ਅੱਗੇ ਮਰਮੇਡ ਜਾਂ SVG ਸਟੋਰ ਕਰੋ। ADR ਬਦਲਣ 'ਤੇ ਅੱਪਡੇਟ ਕਰੋ।
6. ਪ੍ਰਸਤਾਵ
RFC ਨੂੰ ਛੋਟਾ ਰੱਖੋ (1–3 ਪੰਨੇ): ਸਮੱਸਿਆ, ਵਿਕਲਪ (ਘੱਟੋ-ਘੱਟ ਦੋ), ਸਿਫ਼ਾਰਿਸ਼, ਪ੍ਰਭਾਵ (ਸੁਰੱਖਿਆ/ਕੀਮਤ/ਓਪਸ), ਰੋਲਆਊਟ ਅਤੇ ਰੋਲਬੈਕ, ਖੁੱਲ੍ਹੇ ਸਵਾਲ। ਮਨਜ਼ੂਰ ਹੋਣ 'ਤੇ, ਫੈਸਲੇ ਨੂੰ ADR ਵਿੱਚ ਬਦਲ ਦਿਓ।
7. ADR - ਆਰਕੀਟੈਕਚਰ ਫੈਸਲੇ ਦੇ ਰਿਕਾਰਡ
# ADR-00XX: Title Status: Proposed | Accepted | Superseded by ADR-00YY Date: YYYY-MM-DD Deciders: @alice @bob ## Context ## Decision ## Consequences ## Alternatives considered
ADRs ਨੂੰ ਗਿੱਟ ਵਿੱਚ ਰੱਖੋ (docs/adr/). ਉਹਨਾਂ ਨੂੰ PRs ਤੋਂ ਲਿੰਕ ਕਰੋ। ਇਤਿਹਾਸ ਨੂੰ ਮੁੜ ਲਿਖਣ ਦੀ ਬਜਾਏ ਛੱਡ ਦਿਓ।
8. MR ਅਤੇ PR - ਡਿਲੀਵਰੀ ਦੀ ਇਕਾਈ
ਮਿ.ਆਰ (ਮਰਜ ਬੇਨਤੀ) ਅਤੇ ਪੀ.ਆਰ (ਪੁੱਲ ਬੇਨਤੀ) ਉਹੀ ਵਿਚਾਰ ਹਨ: ਇੱਕ ਸਮੀਖਿਆਯੋਗ ਤਬਦੀਲੀ ਸੈੱਟ।
- ਛੋਟਾ (ਅਰਥਪੂਰਨ ਅੰਤਰ ਦੀਆਂ <400 ਲਾਈਨਾਂ ਨੂੰ ਤਰਜੀਹ ਦਿਓ); ਪ੍ਰਤੀ ਬਦਲਾਅ ਇੱਕ ਇਰਾਦਾ।
- ਵਰਣਨ: ਕਿਉਂ, ਕਿਵੇਂ ਟੈਸਟ ਕਰਨਾ ਹੈ, ਜੋਖਮ, ਰੋਲਬੈਕ।
- ਲਿੰਕ: ਟਿਕਟ + ADR + ਚਿੱਤਰ।
- ਫੀਡਬੈਕ ਲਈ ਜਲਦੀ ਡਰਾਫਟ; ਬਿਨਾਂ ਕਿਸੇ ਲਿਖਤੀ ਅਪਵਾਦ ਦੇ ਲਾਲ CI ਜਾਂ ਉੱਚ-ਤੀਬਰਤਾ ਵਾਲੇ ਬੋਟ ਖੋਜਾਂ ਦੇ ਦੁਆਲੇ ਕਦੇ ਵੀ ਜ਼ੋਰ-ਜ਼ਬਰਦਸਤੀ ਨਾ ਕਰੋ।
## Summary ## Test plan - [ ] Unit / contract tests - [ ] Manual path … ## Risk & rollback ## References (ADR, ticket)
9. ਬੋਟ ਦੀ ਸਮੀਖਿਆ ਕਰੋ — ਆਟੋ ਟਿੱਪਣੀਆਂ ਜੋ ਉਤਪਾਦਨ ਦੀ ਸੁਰੱਖਿਆ ਕਰਦੀਆਂ ਹਨ
ਇੱਕ ਸਮੀਖਿਆ ਬੋਟ ਇੱਕ ਸਵੈਚਲਿਤ ਪਹਿਲਾ ਸਮੀਖਿਅਕ ਹੈ। ਇਹ ਮਨੁੱਖਾਂ ਦੀ ਥਾਂ ਨਹੀਂ ਲੈਂਦਾ; ਇਹ ਬੋਰਿੰਗ ਅਤੇ ਖਤਰਨਾਕ ਨੂੰ ਫਰੰਟ-ਲੋਡ ਕਰਦਾ ਹੈ ਇਸਲਈ ਡਿਵੈਲਪਰ ਡਿਜ਼ਾਈਨ ਅਤੇ ਉਤਪਾਦ ਜੋਖਮ 'ਤੇ ਸਮਾਂ ਬਿਤਾਉਂਦੇ ਹਨ।
9.1 ਇਸ 'ਤੇ ਕੀ ਟਿੱਪਣੀ ਕਰਨੀ ਚਾਹੀਦੀ ਹੈ
- ਸੁਰੱਖਿਆ: ਇੰਜੈਕਸ਼ਨ, ਪ੍ਰਮਾਣਿਕਤਾ ਅੰਤਰ, ਗੁਪਤ ਲੀਕੇਜ, ਅਸੁਰੱਖਿਅਤ ਡਿਫਾਲਟਸ
- ਸ਼ੁੱਧਤਾ: ਖਾਲੀ ਰਸਤੇ, ਨਸਲਾਂ, ਟੁੱਟੇ ਹੋਏ ਪਰਵਾਸ
- ਟੈਸਟ: ਨਵੀਆਂ ਸ਼ਾਖਾਵਾਂ 'ਤੇ ਕਵਰੇਜ ਗੁੰਮ ਹੈ
- API/ਕੰਟਰੈਕਟਸ: ਸੰਸਕਰਣ ਬੰਪ ਦੇ ਬਿਨਾਂ ਤਬਦੀਲੀਆਂ ਨੂੰ ਤੋੜਨਾ
- ਓਪਸ: ਗੁੰਮ ਸਮਾਂ ਸਮਾਪਤ, ਬੇਅੰਤ ਮੁੜ ਕੋਸ਼ਿਸ਼ਾਂ, ਗੈਰ-ਇਮਪੋਟੈਂਟ ਲਿਖਤਾਂ
9.2 ਇਹ ਕਿਵੇਂ ਡਿਵੈਲਪਰ ਜੀਵਨ ਨੂੰ ਸੁਚਾਰੂ ਬਣਾਉਂਦਾ ਹੈ
- ਲੇਖਕ ਮਿੰਟਾਂ ਵਿੱਚ PR → ਬੋਟ ਟਿੱਪਣੀਆਂ ਖੋਲ੍ਹਦਾ ਹੈ।
- ਲੇਖਕ ਮਨੁੱਖਾਂ ਨੂੰ ਪੁੱਛਣ ਤੋਂ ਪਹਿਲਾਂ ਠੀਕ ਕਰਦਾ ਹੈ ਜਾਂ ਜਵਾਬ ਦਿੰਦਾ ਹੈ।
- ਮਨੁੱਖੀ ਬੋਟ ਸੰਖੇਪ ਨੂੰ ਪੜ੍ਹਦਾ ਹੈ + ਆਰਕੀਟੈਕਚਰ ਅਤੇ ਧਮਾਕੇ ਦੇ ਘੇਰੇ 'ਤੇ ਧਿਆਨ ਕੇਂਦਰਤ ਕਰਦਾ ਹੈ।
- ਘੱਟ ਨੀਟ ਦੌਰ; ਉਤਪਾਦਨ ਵਿੱਚ ਘੱਟ ਬਚੇ ਹੋਏ ਫੁਟਗਨ।
9.3 ਨੀਤੀ ਜੋ ਬੋਟ ਨੂੰ ਲਾਭਦਾਇਕ ਰੱਖਦੀ ਹੈ
- ਗੰਭੀਰਤਾ: ਬਲੌਕਰ / ਚਾਹੀਦਾ ਹੈ-ਫਿਕਸ / nit — nits ਨੂੰ ਅਭੇਦ ਨਹੀਂ ਕਰਨਾ ਚਾਹੀਦਾ ਹੈ।
- ਤਿਆਰ ਕੀਤੇ ਮਾਰਗਾਂ ਨੂੰ ਅਣਡਿੱਠ ਕਰੋ; ਮਾਸਿਕ ਝੂਠੇ ਸਕਾਰਾਤਮਕ ਟਿਊਨ.
- 'ਤੇ ਮਨੁੱਖੀ ਪ੍ਰਵਾਨਗੀ ਦੀ ਲੋੜ ਹੈ
auth/,infra/, IAM, ਅਤੇ ਪੈਸੇ ਦੇ ਰਸਤੇ। - ਬੋਟ ਨੂੰ ਕਦੇ ਵੀ ਉਤਪਾਦਨ-ਨਾਜ਼ੁਕ ਸੇਵਾਵਾਂ 'ਤੇ ਸਿਰਫ਼ ਸਮੀਖਿਅਕ ਨਾ ਹੋਣ ਦਿਓ।
ਵਾਇਰ SaaS ਬੋਟ (ਉਦਾਹਰਨ ਲਈ CodeRabbit), ਕਰਸਰ ਬੱਗਬੋਟ, ਜਾਂ PR ਅੰਤਰ ਉੱਤੇ ਇੱਕ ਕਸਟਮ ਐਕਸ਼ਨ + LLM। ਸਭ ਤੋਂ ਮਜ਼ਬੂਤ ਆਸਣ ਲਈ ਲੇਅਰ ਲਿੰਟ → SAST → LLM।
10. ਉਤਪਾਦਨ-ਗਰੇਡ ਗੁਣਵੱਤਾ ਲਈ GitOps ਵਧੀਆ ਅਭਿਆਸ
ਇੱਛਤ ਰਾਜ ਗਿਟ ਵਿੱਚ ਰਹਿੰਦਾ ਹੈ। ਇੱਕ ਰੀਕੰਸਿਲਰ (ਆਰਗੋ ਸੀਡੀ, ਫਲੈਕਸ, ਆਦਿ) ਕਲੱਸਟਰ ਦਾ ਮੇਲ ਬਣਾਉਂਦਾ ਹੈ। ਤਰੱਕੀ ਇੱਕ ਅਭੇਦ ਹੈ; ਰੋਲਬੈਕ ਇੱਕ ਵਾਪਸੀ ਹੈ।
- ਵੱਖਰਾ ਐਪ ਕੋਡ ਅਤੇ env ਸੰਰਚਨਾ (ਜਾਂ ਸਾਫ਼
envs/dev|staging|prodਓਵਰਲੇਅ) - ਕੋਈ ਐਡ-ਹਾਕ ਨਹੀਂ
kubectl applyਖੁਸ਼ਹਾਲ ਮਾਰਗ ਦੇ ਰੂਪ ਵਿੱਚ ਅੱਗੇ ਵਧਣ ਲਈ — ਬ੍ਰੇਕ-ਗਲਾਸ ਸਿਰਫ਼, ਆਡਿਟ ਕੀਤਾ ਗਿਆ। - ਪ੍ਰਗਤੀਸ਼ੀਲ ਡਿਲੀਵਰੀ: ਆਟੋ-ਸਿੰਕ ਲੋਅਰ envs; ਉਤਪਾਦ ਲਈ ਗੇਟਡ ਸਿੰਕ।
- ਉਤਪਾਦ ਵਿੱਚ ਪਰਿਵਰਤਨਸ਼ੀਲ ਟੈਗਸ ਉੱਤੇ ਚਿੱਤਰ ਹਜ਼ਮ ਹੁੰਦਾ ਹੈ।
- ਵਿਸ਼ੇਸ਼ ਅਧਿਕਾਰ ਅਤੇ ਰਜਿਸਟਰੀਆਂ ਲਈ ਕੋਡ (OPA/Kyverno) ਵਜੋਂ ਨੀਤੀ।
- ਸਿੰਕ ਤੋਂ ਬਾਅਦ ਵੇਖੋ; ਵਾਪਸੀ ਦਾ ਅਭਿਆਸ ਕਰੋ.
ਕੋਡ ਗੁਣਵੱਤਾ ਸਿਰਫ਼ ਸਾਫ਼ ਫੰਕਸ਼ਨ ਹੀ ਨਹੀਂ ਹੈ - ਇਹ ਵੀ ਹੈ ਪਰਿਵਰਤਨ ਉਤਪਾਦਨ ਵਿੱਚ ਕਿਵੇਂ ਆਉਂਦਾ ਹੈ.
11. ਵਰਕਸਟੇਸ਼ਨ ਮਲਟੀ-ਏਜੰਟ ਆਰਕੀਟੈਕਚਰ — ਮਹਾਨ ਵਿਕਾਸ ਟੀਮਾਂ ਬਣਾਉਣਾ
ਇੱਕ ਸਿੰਗਲ ਬੁੱਧੀਮਾਨ ਡਿਵੈਲਪਰ ਨੂੰ ਅਜੇ ਵੀ ਲਾਭ ਦੀ ਲੋੜ ਹੈ. ਵਰਕਸਟੇਸ਼ਨ ਦਾ ਮਲਟੀ-ਏਜੰਟ ਆਰਕੀਟੈਕਚਰ (ਏਜੰਟਿਕ ਏਆਈ ਵਰਕਸਟੇਸ਼ਨ ਪੈਕੇਜ, ਅਤੇ ਕਾਰੋਬਾਰ ਲਈ ਓਪਨਕਲਾ ਜਿੱਥੇ ਤੁਹਾਨੂੰ ਮੂਰਤ ਜਾਂ ਵਿਸ਼ੇਸ਼ ਏਜੰਟ ਅਮਲੇ ਦੀ ਲੋੜ ਹੈ) ਤੁਹਾਨੂੰ ਇਹ ਕਰਨ ਦਿੰਦਾ ਹੈ ਇੱਕ ਵਿਕਾਸ ਟੀਮ ਨੂੰ ਸਵੈ-ਬਣਾਉਣਾ ਇੱਕ ਕਾਰੋਬਾਰੀ ਸੰਖੇਪ ਦੇ ਦੁਆਲੇ - ਇੱਕ ਸਥਿਰ ਸੰਗਠਨ ਚਾਰਟ ਨਹੀਂ।
11.1 ਰਚਨਾ ਲੂਪ
- ਸੰਖੇਪ - ਹਿੱਸੇਦਾਰ ਨਤੀਜੇ, ਰੁਕਾਵਟਾਂ, SLA।
- ਲਿਖੋ - ਹੁਨਰਾਂ ਲਈ ਭੂਮਿਕਾਵਾਂ ਦਾ ਨਕਸ਼ਾ (ਯੋਜਨਾਕਾਰ, ਨਿਰਮਾਤਾ, ਸਮੀਖਿਅਕ, ਓਪਸ, ਪਾਲਣਾ)।
- ਬੂਟਸਟਰੈਪ — ਏਜੰਟ ਰਨਟਾਈਮ + MCP ਟੂਲ + ਮੈਮੋਰੀ + ਆਡਿਟ ਟ੍ਰੇਲ।
- ਚਲਾਓ — ਏਜੰਟ ਕੰਮ ਖਿੱਚਦੇ ਹਨ, Spec/AC ਦੇ ਵਿਰੁੱਧ ਲਾਗੂ ਕਰਦੇ ਹਨ, ਹਰ ਕਦਮ ਦੀ ਛੋਟੀ-ਸਮੀਖਿਆ ਕਰਦੇ ਹਨ।
- ਸਮੀਖਿਆ-ਸਾਫ਼-ਸਾਫ਼ ਹੋਣ ਤੱਕ - ਬੋਟ + ਸਮੀਖਿਅਕ ਏਜੰਟ + ਮਨੁੱਖੀ ਗੇਟਾਂ ਦੀ ਸਮੀਖਿਆ ਕਰੋ।
- ਜਹਾਜ਼ - GitOps ਮਹੱਤਵਪੂਰਨ ਵਾਤਾਵਰਣ ਨੂੰ ਉਤਸ਼ਾਹਿਤ ਕਰਦੇ ਹਨ।
11.2 ਭੂਮਿਕਾ ਦਾ ਨਕਸ਼ਾ (ਮਨੁੱਖੀ + ਏਜੰਟ)
| ਭੂਮਿਕਾ | ਏਜੰਟ ਕਰਦਾ ਹੈ | ਮਨੁੱਖ ਅਜੇ ਵੀ ਮਾਲਕ ਹੈ |
|---|---|---|
| ਯੋਜਨਾਕਾਰ | ਸਪੇਕ ਤੋਂ ਐਪਿਕਸ, ਕਹਾਣੀਆਂ, ਏ.ਸੀ | ਤਰਜੀਹ ਅਤੇ ਦਾਇਰੇ ਵਿੱਚ ਕਟੌਤੀ |
| ਬਿਲਡਰਜ਼ | ਸਮਾਨਾਂਤਰ ਲਾਗੂ ਕਰਨਾ, ਟੈਸਟ | ਸਖ਼ਤ ਕਿਨਾਰਿਆਂ 'ਤੇ ਡੋਮੇਨ ਦਾ ਨਿਰਣਾ |
| ਸਮੀਖਿਅਕ | ਵਿਸ਼ੇਸ਼ਤਾ ਦੀ ਪਾਲਣਾ, ਬੋਟ ਟ੍ਰਾਈਜ ਦੀ ਸਮੀਖਿਆ ਕਰੋ | ਆਰਕੀਟੈਕਚਰ ਅਤੇ ਉਤਪਾਦ ਸਾਈਨ-ਆਫ |
| ਓਪਸ | GitOps ਸਿੰਕ, SLO ਵਾਚ, ਡਰਾਫਟ ਰੋਲਬੈਕ | ਗੋ-ਲਿਵ ਅਤੇ ਘਟਨਾ ਹੁਕਮ |
| HITL ਗੇਟ | ਜੋਖਮ ਭਰੇ ਲਿਖੋ / ਖਰਚ ਕਰੋ | ਮਨਜ਼ੂਰ ਜਾਂ ਅਸਵੀਕਾਰ ਕਰੋ |
11.3 ਇਹ ਮਹਾਨ ਟੀਮਾਂ ਕਿਉਂ ਬਣਾਉਂਦਾ ਹੈ
- ਵਿਸ਼ੇਸ਼ਤਾ - ਹਰੇਕ ਏਜੰਟ ਦੀ ਇੱਕ ਨੌਕਰੀ ਹੁੰਦੀ ਹੈ; ਗੁਣਵੱਤਾ ਉਦੋਂ ਵਧਦੀ ਹੈ ਜਦੋਂ ਭੂਮਿਕਾਵਾਂ ਧੁੰਦਲੀਆਂ ਨਹੀਂ ਹੁੰਦੀਆਂ।
- ਹਫੜਾ-ਦਫੜੀ ਤੋਂ ਬਿਨਾਂ ਥ੍ਰੂਪੁੱਟ - ਇੱਕ ਸਿੰਗਲ ਸਪੇਕ ਅਤੇ ਰਿਵਿਊ ਬੋਟ ਦੇ ਪਿੱਛੇ ਸਮਾਨਾਂਤਰ ਬਿਲਡਰ।
- ਫੈਸਲਿਆਂ ਦੀ ਯਾਦ ਸਾਂਝੀ ਕੀਤੀ — ADRs + Spec + PR ਇਤਿਹਾਸ ਟੀਮ ਦੀ ਲੰਬੀ-ਅਵਧੀ ਦੀ ਯਾਦ ਬਣ ਜਾਂਦੇ ਹਨ।
- ਮਨੁੱਖਾਂ ਦੇ ਸਮਾਨ ਦਰਵਾਜ਼ੇ — CI, ਰਿਵਿਊ ਬੋਟ, CODEOWNERS, GitOps — ਏਜੰਟ ਉਤਪਾਦਨ ਅਨੁਸ਼ਾਸਨ ਨੂੰ ਬਾਈਪਾਸ ਨਹੀਂ ਕਰਦੇ ਹਨ।
- ਵਪਾਰ ਦੀ ਗਤੀ — ਹਰ ਸਪਾਈਕ ਲਈ ਕਿਰਾਏ 'ਤੇ ਲੈਣ ਲਈ ਹਫ਼ਤਿਆਂ ਦੀ ਬਜਾਏ ਸਮਰੱਥ ਚਾਲਕ ਦਲ ਨੂੰ ਖੜ੍ਹਾ ਕਰਨ ਲਈ ਘੰਟੇ।
11.4 ਇਹ ਬੁੱਧੀਮਾਨ ਮਾਰਗ ਵਿੱਚ ਕਿਵੇਂ ਪਲੱਗ ਕਰਦਾ ਹੈ
ਬ੍ਰੇਨਸਟਾਰਮ ਅਤੇ ਚਰਚਾ ਅਜੇ ਵੀ ਮਨੁੱਖਾਂ ਨਾਲ ਹੁੰਦੀ ਹੈ। ਪ੍ਰੋਟੋਟਾਈਪ ਅਤੇ ਡਾਇਗ੍ਰਾਮ ਅਜੇ ਵੀ ਵਾਪਰਦੇ ਹਨ. ਬਹੁ-ਏਜੰਟ ਚਾਲਕ ਦਲ ਤੇਜ਼ ਕਰਦਾ ਹੈ ਪ੍ਰਸਤਾਵ ਦਾ ਖਰੜਾ ਤਿਆਰ ਕਰਨਾ, ADR ਸਕੈਫੋਲਡਿੰਗ, ਲਾਗੂ ਕਰਨ ਦੇ ਟੁਕੜੇ, ਬੋਟ ਟ੍ਰਾਈਜ ਦੀ ਸਮੀਖਿਆ ਕਰੋ, ਅਤੇ GitOps ਤਰੱਕੀ - ਜਦੋਂ ਕਿ ਮਨੁੱਖ ਨਤੀਜਿਆਂ ਅਤੇ ਜੋਖਮਾਂ 'ਤੇ ਨਿਰਣਾ ਰੱਖਦੇ ਹਨ। ਇਹ ਵਰਕਸਟੇਸ਼ਨ ਮਾਡਲ ਹੈ: ਏਜੰਟ ਵਰਕਸਟੇਸ਼ਨ ਅਤੇ ਓਪਨਕਲੌ ਪੈਕੇਜ ਤੁਹਾਡੇ ਵਰਕਫਲੋਜ਼ ਲਈ ਕੌਂਫਿਗਰ ਕੀਤੇ ਗਏ ਹਨ, ਨਾ ਕਿ ਇੱਕ ਟੀਮ ਹੋਣ ਦਾ ਦਿਖਾਵਾ ਕਰਨ ਵਾਲੀ ਚੈਟ ਵਿੰਡੋ।
12. ਐਂਡ-ਟੂ-ਐਂਡ ਕੁਆਲਿਟੀ ਗੇਟ
Local: pre-commit (fmt, lint, secrets) + unit tests PR open: CI + Review Bot comments PR merge: human approve + branch protection + required checks Main: immutable artifact (image digest) GitOps: update env overlay → sync → verify Agents: Planner/Builder/Reviewer/Ops stay inside the same gates Prod: SLOs + alerts + runbook linked from ADR/PR
13. ਸਟਾਰਟਰ ਚੈਕਲਿਸਟ
- ਬਣਾਓ
docs/ideas/,docs/architecture/,docs/adr/ - PR/MR ਟੈਂਪਲੇਟ + CODEOWNERS + ਸ਼ਾਖਾ ਸੁਰੱਖਿਆ ਸ਼ਾਮਲ ਕਰੋ
- ਪ੍ਰੀ-ਕਮਿਟ + CI ਲੋੜੀਂਦੀਆਂ ਜਾਂਚਾਂ ਨੂੰ ਸਮਰੱਥ ਬਣਾਓ
- ਰੀਵਿਊ ਬੋਟ ਸਥਾਪਿਤ ਕਰੋ; ਟਿਊਨ ਪਾਥ ਫਿਲਟਰ ਅਤੇ ਗੰਭੀਰਤਾ
- ADR-0001 ਲਿਖੋ: "ਅਸੀਂ ਤੈਨਾਤ ਕਰਨ ਲਈ GitOps ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹਾਂ"
- env ਪ੍ਰੋਮੋਸ਼ਨ ਨਿਯਮਾਂ ਅਤੇ ਰੋਲਬੈਕ ਗੇਮ ਡੇ ਨੂੰ ਪਰਿਭਾਸ਼ਿਤ ਕਰੋ
- ਜੇ ਸਕੇਲਿੰਗ ਡਿਲੀਵਰੀ: HITL ਗੇਟਾਂ ਦੇ ਨਾਲ ਵਰਕਸਟੇਸ਼ਨ ਮਲਟੀ-ਏਜੰਟ ਕਰੂ (ਪਲਾਨਰ/ਬਿਲਡਰ/ਸਮੀਖਿਅਕ/ਓਪਸ) ਸਟੈਂਡ ਅੱਪ ਕਰੋ
14. ਵਿਰੋਧੀ ਪੈਟਰਨ
- ਵਿਸ਼ਾਲ "WIP ਕਿਰਪਾ ਕਰਕੇ ਮਨਜ਼ੂਰੀ ਦਿਓ" PR
- ਆਰਕੀਟੈਕਚਰ ਸਿਰਫ ਸਲੈਕ ਵਿੱਚ - ਕਦੇ ਵੀ ADR ਵਿੱਚ ਨਹੀਂ
- ਪ੍ਰੋਟੋਟਾਈਪ ਨੂੰ ਬਿਨਾਂ ਟੈਸਟਾਂ ਦੇ ਉਤਪਾਦ ਦੇ ਤੌਰ 'ਤੇ ਮਿਲਾ ਦਿੱਤਾ ਗਿਆ
- ਸਮੀਖਿਆ ਬੋਟ ਨੂੰ ਅਸਮਰੱਥ ਬਣਾਉਣਾ ਕਿਉਂਕਿ ਇਹ ਪਰੇਸ਼ਾਨ ਕਰਦਾ ਹੈ
- ਲਿਖਣ ਦੀ ਪਹੁੰਚ ਵਾਲੇ ਏਜੰਟ ਅਤੇ ਕੋਈ ਮਨੁੱਖੀ ਗੇਟ ਨਹੀਂ
- ਬਿਨਾਂ ਕਿਸੇ ਵਾਪਸੀ ਯੋਜਨਾ ਦੇ GitOps ਤੋਂ ਬਾਹਰ ਉਤਪਾਦਨ ਲਈ ਹੌਟਫਿਕਸ
15. ਬੰਦ ਕਰਨਾ
ਇੱਕ ਬੁੱਧੀਮਾਨ ਡਿਵੈਲਪਰ ਇੱਕ ਨਵੇਂ ਪ੍ਰੋਜੈਕਟ ਨੂੰ ਸਿੱਖਣ ਦੀਆਂ ਕਲਾਕ੍ਰਿਤੀਆਂ ਦੇ ਇੱਕ ਕ੍ਰਮ ਦੇ ਰੂਪ ਵਿੱਚ ਸਮਝਦਾ ਹੈ — ਨੋਟਸ, ਚਿੱਤਰ, ਪ੍ਰਸਤਾਵ, ADR — ਫਿਰ ਇੱਕ ਸਮੀਖਿਆ ਬੋਟ ਦੁਆਰਾ ਦੇਖੇ ਗਏ ਅਤੇ GitOps ਦੁਆਰਾ ਪ੍ਰਮੋਟ ਕੀਤੇ ਛੋਟੇ MRs/PRs ਦੁਆਰਾ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ। ਵਰਕਸਟੇਸ਼ਨ ਦਾ ਮਲਟੀ-ਏਜੰਟ ਆਰਕੀਟੈਕਚਰ ਉਸ ਬੁੱਧੀ ਨੂੰ ਇੱਕ ਪੂਰੀ ਵਿਕਾਸ ਟੀਮ ਵਿੱਚ ਵਿਸਤਾਰ ਕਰਦਾ ਹੈ: ਵਿਸ਼ੇਸ਼ ਏਜੰਟ, ਸ਼ੇਅਰਡ ਸਪੇਕ, ਮਨੁੱਖੀ ਨਿਰਣਾ ਜਿੱਥੇ ਇਹ ਮਾਇਨੇ ਰੱਖਦਾ ਹੈ, ਅਤੇ ਰਹਿਣ ਦੇ ਹਰ ਰਸਤੇ 'ਤੇ ਉਤਪਾਦਨ-ਗਰੇਡ ਗੇਟਸ। ਇਸ ਤਰ੍ਹਾਂ ਕੋਡ ਗੁਣਵੱਤਾ ਉਤਪਾਦਨ ਲਈ ਅਨੁਕੂਲ ਬਣੀ ਰਹਿੰਦੀ ਹੈ ਜਦੋਂ ਕਿ ਕਾਰੋਬਾਰ ਅਜੇ ਵੀ ਤੇਜ਼ੀ ਨਾਲ ਅੱਗੇ ਵਧਦਾ ਹੈ।
ਦੁਆਰਾ ਪ੍ਰਕਾਸ਼ਿਤ ਵਰਕਸਟੇਸ਼ਨ.