AbsaOSS / AbsaOSS/agentic-toolkit

Add a spec-first / scoping workflow guide

Đang mở
#22 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
documentation
Ngôn ngữ chính
Python
Star
1
Fork
0
Merge trung bình
16 giờ 52 phút
Pull request đã merge (30 ngày)
1

Mô tả

## Summary

Add a **spec-first / scoping workflow** guide (and optionally a `spec-writer` skill). We use AI for well-defined scope; the missing piece is documented discipline for *getting to* that scope. Spec-first work means fewer correction loops, which means fewer tokens per task — the metric that actually drives cost.

## The guide should cover

- Why scoping/spec-first reduces cost (tokens-per-task, not per-token price).
- A practical loop: spec → plan → execute → verify.
- How to write a good spec / acceptance criteria for an agent.
- When a task is too vague to hand to an agent, and how to tighten it.
- Optionally: a `spec-writer` skill that helps draft a spec from a rough idea.

## Notes

- Back the findings with web research across multiple independent sources.
- Keep it tool-general (GitHub Copilot CLI, OpenCode, Pi).
- Tie in with existing material on agent mode and token budget.

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Đánh giá

Issue này chưa được đánh giá.

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.