KnownsTasks
Track work with tasks, acceptance criteria, and links.
On this page
Tasks are the main unit of planned work in Knowns.
What a task contains
A task may include:
- title
- description
- status
- priority
- labels
- assignee
- acceptance criteria
- implementation plan
- implementation notes
Why tasks matter
Tasks give both humans and AI a concrete execution target.
Instead of saying “work on auth,” you can define:
- what should be built
- how success is checked
- what context is relevant
- what the current progress is
Typical flow
knowns task create "Add authentication" \
-d "JWT-based auth with login and register endpoints" \
--ac "User can register" \
--ac "User can login" \
--priority high
# Optional one-off ID namespace; creates an ID such as FR-4F7Q2M
knowns task create "Add authentication feature" --prefix FR
knowns task edit <id> -s in-progress
knowns task edit <id> --plan $'1. Review auth pattern\n2. Implement endpoints\n3. Add tests'
knowns task edit <id> --check-ac 1
knowns task edit <id> --append-notes "Completed middleware"
knowns task edit <id> -s done
The task ID is immutable and remains the only public identifier. A project may
set settings.defaultTaskIdPrefix; a caller-provided --prefix overrides it
for one task without changing config. Existing numeric, hierarchical, and
six-character random IDs remain readable and require no migration.
Acceptance criteria
Acceptance criteria are especially valuable for AI-assisted work because they make “done” testable.
Good acceptance criteria are:
- concrete
- observable
- small enough to check individually
References inside tasks
Tasks can reference docs and other entities, for example:
@doc/architecture/auth@task-abc123
Related
Task là đơn vị công việc chính trong Knowns.
Task gồm gì?
- title
- description
- status
- priority
- labels
- assignee
- acceptance criteria
- implementation plan
- implementation notes
Tại sao cần task?
Task cho cả người và AI một mục tiêu rõ ràng.
Thay vì nói "làm phần auth đi", define cụ thể:
- cần build gì
- check thành công bằng cách nào
- context nào liên quan
- đang làm đến đâu
Flow điển hình
knowns task create "Add authentication" \
-d "JWT-based auth with login and register endpoints" \
--ac "User can register" \
--ac "User can login" \
--priority high
# Namespace ID tuỳ chọn cho một task; tạo ID như FR-4F7Q2M
knowns task create "Add authentication feature" --prefix FR
knowns task edit <id> -s in-progress
knowns task edit <id> --plan '1. Review auth pattern\n2. Implement endpoints\n3. Add tests'
knowns task edit <id> --check-ac 1
knowns task edit <id> --append-notes "Completed middleware"
knowns task edit <id> -s done
Task ID là immutable và vẫn là public identifier duy nhất. Project có thể set
settings.defaultTaskIdPrefix; --prefix chỉ override cho task đang tạo và
không đổi config. Các ID numeric, hierarchical và random 6 ký tự cũ vẫn đọc
được, không cần migration.
Acceptance criteria
AC đặc biệt quan trọng khi làm việc với AI — biến khái niệm "xong" thành thứ kiểm tra được.
AC tốt nên:
- cụ thể
- observable
- đủ nhỏ để check từng cái
Reference trong task
Task có thể reference tới doc hoặc entity khác:
@doc/architecture/auth@task-abc123