AbsaOSS / AbsaOSS/agentic-toolkit

Add a spec-first / scoping workflow guide

Open
#22 0 comments 0 reactions 0 assignees View on GitHub
documentation
Dominant language
Python
Stars
1
Forks
0
Avg merge
16h 52m
Merged PRs (30d)
1

Description

## 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.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.