ttal-comment

ttal-comment Skill

Overview

ttal comment is the unified tool for posting and reading review comments in the pipeline. Use it for plan reviews, PR reviews, triage reports, and verdicts.

Commands

ttal comment list                    # list all comments on current task
ttal comment get <round>             # read specific review round
ttal comment add "message"           # post comment (short messages)
ttal comment lgtm                    # approve current pipeline stage (reviewers only, auto-detects stage)

For multiline reports, use heredoc:

cat <<'REVIEW' | ttal comment add
## Review Findings
**Verdict:** Ready
REVIEW

Triage Pattern

When receiving a review comment with findings:

1. Read the comment: ttal comment list then ttal comment get <round>
2. Assess each finding: Fixed / Not Applicable / Remaining
3. Fix what needs fixing
4. Post a structured triage update:

cat <<'TRIAGE' | ttal comment add
## Triage Report (Round N)

**Fixed:**
- Issue 1 — what was done
- Issue 2 — what was done

**Not Applicable:**
- Issue 3 — why it doesn't apply

**Remaining:**
- Issue 4 — why it's deferred (or still being worked)
TRIAGE

5. If no remaining blocking issues: run ttal go <uuid> to advance the pipeline

After LGTM

When a reviewer posts LGTM with no remaining blocking issues:

• Run ttal go <uuid> to advance the pipeline (reviewers use ttal comment lgtm which sets the tag automatically)
• You do NOT need to post anything — the pipeline advances on the lgtm tag

Rules

• Always post via ttal comment add — never output findings inline only
• Use heredoc for any report longer than one line
• Reviewers: always call ttal comment lgtm after approving — this sets the correct pipeline tag
• Coders: after receiving LGTM, run ttal go <uuid> to finalize