@fitlab-ai/agent-infra 0.4.0 → 0.4.1

package/README.md

@@ -380,8 +380,7 @@ The generated `.agents/.airc.json` file is the central contract between the boot
   "project": "my-project",
   "org": "my-org",
   "language": "en",
-  "templateSource": "templates/",
-  "templateVersion": "v0.4.0",
+  "templateVersion": "v0.4.1",
   "files": {
     "managed": [
       ".agents/workspace/README.md",
@@ -409,7 +408,6 @@ The generated `.agents/.airc.json` file is the central contract between the boot
 | `project` | Project name used when rendering commands, paths, and templates. |
 | `org` | GitHub organization or owner used by generated metadata and links. |
 | `language` | Primary project language or locale used by rendered templates. |
-| `templateSource` | Local template root used during rendering. |
 | `templateVersion` | Installed template version for future upgrades and drift tracking. |
 | `files` | Per-path update strategy configuration for managed, merged, and ejected files. |
 

package/README.zh-CN.md

@@ -380,8 +380,7 @@ import-issue #42                    从 GitHub Issue 导入任务
   "project": "my-project",
   "org": "my-org",
   "language": "en",
-  "templateSource": "templates/",
-  "templateVersion": "v0.4.0",
+  "templateVersion": "v0.4.1",
   "files": {
     "managed": [
       ".agents/workspace/README.md",
@@ -409,7 +408,6 @@ import-issue #42                    从 GitHub Issue 导入任务
 | `project` | 用于渲染命令、路径和模板内容的项目名。 |
 | `org` | 生成元数据和链接时使用的 GitHub 组织或拥有者。 |
 | `language` | 渲染模板时采用的项目主语言或区域设置。 |
-| `templateSource` | 本地模板根目录。 |
 | `templateVersion` | 当前安装的模板版本，用于升级和差异追踪。 |
 | `files` | 针对具体路径配置 `managed`、`merged`、`ejected` 三类更新策略。 |
 

package/lib/defaults.json

@@ -8,6 +8,7 @@
       ".claude/commands/",
       ".claude/hooks/",
       ".gemini/commands/",
+      ".github/hooks/check-version-format.sh",
       ".opencode/commands/"
     ],
     "merged": [
@@ -26,6 +27,7 @@
       ".claude/settings.json",
       ".codex/README.md",
       ".gemini/settings.json",
+      ".github/hooks/pre-commit",
       ".gitignore",
       ".opencode/COMMAND_STYLE_GUIDE.md",
       ".opencode/README.md",

package/lib/init.js

@@ -57,11 +57,7 @@ async function cmdInit() {
   const configPath = path.join('.agents', '.airc.json');
 
   // check existing config
-  if (
-    fs.existsSync(configPath) ||
-    fs.existsSync('.airc.json') ||
-    fs.existsSync(path.join('.agent-infra', 'config.json'))
-  ) {
+  if (fs.existsSync(configPath)) {
     err('This project already has agent-infra configuration.');
     err('Use /update-agent-infra in your AI TUI to update.');
     process.exitCode = 1;
@@ -165,7 +161,6 @@ async function cmdInit() {
     project: projectName,
     org: orgName,
     language,
-    templateSource: 'templates/',
     templateVersion: VERSION,
     files: structuredClone(defaults.files)
   };

package/lib/update.js

@@ -10,52 +10,6 @@ const defaults = JSON.parse(
 
 const CONFIG_DIR = '.agents';
 const CONFIG_PATH = path.join(CONFIG_DIR, '.airc.json');
-const LEGACY_CONFIG_PATHS = ['.airc.json', path.join('.agent-infra', 'config.json')];
-const WORKSPACE_PATH = path.join(CONFIG_DIR, 'workspace');
-const LEGACY_WORKSPACE_PATHS = ['.agent-workspace', path.join('.agent-infra', 'workspace')];
-
-function migrateLegacyPaths() {
-  let migratedConfig = false;
-  let migratedWorkspace = false;
-  let configFrom = null;
-  let workspaceFrom = null;
-
-  if (!fs.existsSync(CONFIG_PATH)) {
-    for (const legacyPath of LEGACY_CONFIG_PATHS) {
-      if (!fs.existsSync(legacyPath)) {
-        continue;
-      }
-      fs.mkdirSync(CONFIG_DIR, { recursive: true });
-      fs.renameSync(legacyPath, CONFIG_PATH);
-      migratedConfig = true;
-      configFrom = legacyPath;
-      break;
-    }
-  }
-
-  if (!fs.existsSync(WORKSPACE_PATH)) {
-    for (const legacyPath of LEGACY_WORKSPACE_PATHS) {
-      if (!fs.existsSync(legacyPath)) {
-        continue;
-      }
-      fs.mkdirSync(CONFIG_DIR, { recursive: true });
-      fs.renameSync(legacyPath, WORKSPACE_PATH);
-      migratedWorkspace = true;
-      workspaceFrom = legacyPath;
-      break;
-    }
-  }
-
-  try {
-    if (fs.existsSync('.agent-infra') && fs.readdirSync('.agent-infra').length === 0) {
-      fs.rmdirSync('.agent-infra');
-    }
-  } catch {
-    // Ignore cleanup failures for partially migrated directories.
-  }
-
-  return { migratedConfig, migratedWorkspace, configFrom, workspaceFrom };
-}
 
 function syncFileRegistry(config) {
   config.files ||= {};
@@ -107,15 +61,6 @@ async function cmdUpdate() {
   console.log('  ==================================');
   console.log('');
 
-  const { migratedConfig, migratedWorkspace, configFrom, workspaceFrom } = migrateLegacyPaths();
-
-  if (migratedConfig) {
-    ok(`Migrated ${configFrom} -> ${CONFIG_PATH}`);
-  }
-  if (migratedWorkspace) {
-    ok(`Migrated ${workspaceFrom} -> ${WORKSPACE_PATH}`);
-  }
-
   // check config exists
   if (!fs.existsSync(CONFIG_PATH)) {
     err(`No ${CONFIG_PATH} found in current directory.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fitlab-ai/agent-infra",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Bootstrap tool for AI multi-tool collaboration infrastructure — works with Claude Code, Codex, Gemini CLI, and OpenCode",
   "license": "MIT",
   "type": "module",

package/templates/.agents/QUICKSTART.md

@@ -8,6 +8,16 @@ This guide walks you through using multiple AI coding assistants together on a p
 - A project with `.agents/` directory set up (this project)
 - Familiarity with your project's codebase
 
+## Git Hook Setup
+
+Enable the shared Git hooks path before relying on the template hook chain:
+
+```bash
+git config core.hooksPath .github/hooks
+```
+
+This makes Git invoke the hooks synced into `.github/hooks/`, including `pre-commit` and `check-version-format.sh`.
+
 ## Creating Your First Task
 
 1. Copy the task template to the active workspace:

package/templates/.agents/QUICKSTART.zh-CN.md

@@ -8,6 +8,16 @@
 - 项目已设置 `.agents/` 目录（本项目已就绪）
 - 熟悉你的项目代码库
 
+## Git Hook 配置
+
+在依赖模板中的 Git hook 链路前，先启用共享 hooks 路径：
+
+```bash
+git config core.hooksPath .github/hooks
+```
+
+这样 Git 才会调用同步到 `.github/hooks/` 下的 hook，包括 `pre-commit` 和 `check-version-format.sh`。
+
 ## 创建第一个任务
 
 1. 将任务模板复制到活跃工作区：

package/templates/.agents/README.md

@@ -36,12 +36,11 @@ This dual-config approach ensures every AI tool receives appropriate project con
     bug-fix.yaml                # Bug fix workflow
     code-review.yaml            # Code review workflow
     refactoring.yaml            # Refactoring workflow
-
-.agents/workspace/         # Runtime workspace (git-ignored)
-  active/                       # Currently active tasks
-  blocked/                      # Blocked tasks
-  completed/                    # Completed tasks
-  logs/                         # Collaboration logs
+  workspace/                    # Runtime workspace (git-ignored)
+    active/                     # Currently active tasks
+    blocked/                    # Blocked tasks
+    completed/                  # Completed tasks
+    logs/                       # Collaboration logs
 
 .claude/                        # Claude Code specific config
   CLAUDE.md                     # Project instructions for Claude
@@ -53,11 +52,12 @@ This dual-config approach ensures every AI tool receives appropriate project con
 
 The multi-AI collaboration follows a structured workflow:
 
-```
-1. Analysis    -->  2. Design    -->  3. Implementation
-                                            |
-6. Commit  <--  5. Fix Issues  <--  4. Review
-```
+1. Analysis
+2. Design
+3. Implementation
+4. Review
+5. Fix Issues
+6. Commit
 
 ### Phase Details
 
@@ -123,6 +123,13 @@ When writing or updating `.agents/skills/*/SKILL.md` files and their templates,
 5. When renumbering, update every in-document step reference so the instructions remain accurate.
 6. Extract long bash scripts into a sibling `scripts/` directory; the SKILL.md should contain only a single-line invocation (e.g., `bash .agents/skills/<skill>/scripts/<script>.sh`) and a brief summary of the script's responsibilities.
 
+### SKILL.md Size Control
+
+- Keep the SKILL.md body within about 500 tokens (roughly 80 lines / 2KB).
+- Move content beyond that threshold into a sibling `reference/` directory.
+- Use explicit navigation in the skeleton, such as: `Read reference/xxx.md before executing this step.`
+- Keep scripts in `scripts/` and execute them instead of inlining long bash blocks.
+
 ## FAQ
 
 ### Q: Do I need to configure every AI tool separately?

package/templates/.agents/README.zh-CN.md

@@ -36,12 +36,11 @@
     bug-fix.yaml                # 缺陷修复工作流
     code-review.yaml            # 代码审查工作流
     refactoring.yaml            # 重构工作流
-
-.agents/workspace/         # 运行时工作区（已被 git ignore）
-  active/                       # 当前活跃任务
-  blocked/                      # 被阻塞的任务
-  completed/                    # 已完成的任务
-  logs/                         # 协作日志
+  workspace/                    # 运行时工作区（已被 git ignore）
+    active/                     # 当前活跃任务
+    blocked/                    # 被阻塞的任务
+    completed/                  # 已完成的任务
+    logs/                       # 协作日志
 
 .claude/                        # Claude Code 专属配置
   CLAUDE.md                     # Claude 项目指令
@@ -53,11 +52,12 @@
 
 多 AI 协作遵循结构化工作流：
 
-```
-1. 分析    -->  2. 设计    -->  3. 实现
-                                    |
-6. 提交  <--  5. 修复问题  <--  4. 审查
-```
+1. 分析
+2. 设计
+3. 实现
+4. 审查
+5. 修复问题
+6. 提交
 
 ### 阶段详情
 
@@ -123,6 +123,13 @@
 5. 调整编号时，必须同步更新文中的步骤引用，确保说明、命令和检查点一致。
 6. 长 bash 脚本应从 SKILL.md 提取到同级 `scripts/` 目录中，SKILL.md 只保留单行调用（如 `bash .agents/skills/<skill>/scripts/<script>.sh`）和对脚本职责的概要说明。
 
+### SKILL.md 体积控制
+
+- SKILL.md 正文控制在约 500 tokens（约 80 行 / 2KB）以内。
+- 超过阈值的内容拆分到同级 `reference/` 目录。
+- 骨架中使用明确导航，例如：`执行此步骤前，先读取 reference/xxx.md。`
+- 长脚本继续放在 `scripts/` 目录，优先执行脚本而不是内联大段 bash。
+
 ## 常见问题
 
 ### Q：我需要单独配置每个 AI 工具吗？

package/templates/.agents/skills/analyze-task/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: analyze-task
-description: >
-  Analyze an existing task and output a requirements analysis document,
-  supporting multi-round artifacts (`analysis.md` / `analysis-r{N}.md`).
-  Triggered when the user asks to analyze a task. Argument: task-id.
+description: "Analyze a task and produce a requirements document"
 ---
 
 # Analyze Task

package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md

@@ -1,8 +1,6 @@
 ---
 name: analyze-task
-description: >
-  分析已有任务并输出需求分析文档，支持多轮分析产物（analysis.md / analysis-r{N}.md）。
-  当用户要求分析某个任务时触发。参数：task-id。
+description: "分析任务并输出需求分析文档"
 ---
 
 # 分析任务

package/templates/.agents/skills/block-task/SKILL.md

@@ -1,10 +1,6 @@
 ---
 name: block-task
-description: >
-  Mark a task as blocked and record the blocking reason, moving it from
-  the active directory to the blocked directory. Use when a task cannot
-  proceed due to technical problems, unclear requirements, missing resources,
-  or pending decisions. Arguments: task-id, optional blocking reason.
+description: "Mark a task as blocked and record the reason"
 ---
 
 # Block Task

package/templates/.agents/skills/block-task/SKILL.zh-CN.md

@@ -1,9 +1,6 @@
 ---
 name: block-task
-description: >
-  标记任务为阻塞状态并记录阻塞原因，将其从 active 目录移动到 blocked 目录。
-  当任务因技术问题、需求不清晰、缺少资源或待定决策而无法继续时使用。
-  参数：task-id，可选的阻塞原因。
+description: "标记任务为阻塞状态并记录原因"
 ---
 
 # 标记任务阻塞

package/templates/.agents/skills/check-task/SKILL.md

@@ -1,10 +1,6 @@
 ---
 name: check-task
-description: >
-  Check a task's current status, workflow progress, and context files. This is a
-  read-only operation that reports the task status and recommends appropriate
-  next steps. Triggered when the user asks to inspect task status. Argument:
-  task-id.
+description: "Check a task's current status and progress"
 ---
 
 # Check Task Status

package/templates/.agents/skills/check-task/SKILL.zh-CN.md

@@ -1,8 +1,6 @@
 ---
 name: check-task
-description: >
-  查看任务的当前状态、工作流进度和上下文文件。这是只读操作，报告任务状态并建议
-  适当的下一步操作。当用户要求查看任务状态时触发。参数：task-id。
+description: "查看任务的当前状态和进度"
 ---
 
 # 查看任务状态

package/templates/.agents/skills/close-codescan/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: close-codescan
-description: >
-  Dismiss a Code Scanning (CodeQL) alert with a documented justification.
-  Triggered when the user asks to dismiss a Code Scanning alert.
-  Argument: alert number.
+description: "Close a Code Scanning alert with a documented reason"
 ---
 
 # Dismiss Code Scanning Alert

package/templates/.agents/skills/close-codescan/SKILL.zh-CN.md

@@ -1,8 +1,6 @@
 ---
 name: close-codescan
-description: >
-  关闭 Code Scanning（CodeQL）告警并提供有据可查的理由。
-  当用户要求关闭 Code Scanning 告警时触发。参数：告警编号。
+description: "关闭 Code Scanning 告警并记录理由"
 ---
 
 # 关闭 Code Scanning 告警

package/templates/.agents/skills/close-dependabot/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: close-dependabot
-description: >
-  Dismiss a Dependabot security alert with a documented justification.
-  Triggered when the user asks to dismiss a Dependabot alert.
-  Argument: alert number.
+description: "Close a Dependabot alert with a documented reason"
 ---
 
 # Dismiss Dependabot Alert

package/templates/.agents/skills/close-dependabot/SKILL.zh-CN.md

@@ -1,8 +1,6 @@
 ---
 name: close-dependabot
-description: >
-  关闭 Dependabot 安全告警并提供有据可查的理由。
-  当用户要求关闭 Dependabot 告警时触发。参数：告警编号。
+description: "关闭 Dependabot 安全告警并记录理由"
 ---
 
 # 关闭 Dependabot 告警

package/templates/.agents/skills/commit/SKILL.md

@@ -1,139 +1,40 @@
 ---
 name: commit
-description: >
-  Commit current changes to Git, including copyright header year
-  check and task status update. Triggered when the user requests
-  a code commit or save changes.
+description: "Commit the current changes to Git"
 ---
 
 # Commit Changes
 
-Commit current changes to Git.
+Create a Git commit without overwriting user work and update the related task state when needed.
 
-## Step 0: Check Local Modifications (CRITICAL)
+## 1. Check Local Modifications (CRITICAL)
 
-**Mandatory**: Before any edits, you **must** check the user's local modifications to avoid overwriting their work.
+Before any edit, inspect:
 
 ```bash
 git status --short
 git diff
 ```
 
-**Rules**:
-1. **Read `git diff` output carefully** - understand what the user has already changed
-2. **Make incremental edits** on top of user modifications - do not overwrite their implementation
-3. **If your planned edits conflict** with user modifications, ask the user first:
-   ```
-   This file has local modifications:
-   - Your changes: [describe user's changes]
-   - My planned changes: [describe planned changes]
-   Please confirm how to proceed.
-   ```
-4. **Do NOT** rewrite code the user has already implemented
-5. **Do NOT** add "improvements" the user didn't ask for
+Respect existing user changes. If your planned edit conflicts with them, stop and ask before proceeding.
 
-## Step 1: Update Copyright Header Years (CRITICAL)
+## 2. Update Copyright Headers
 
-**Mandatory**: Before committing, check and update copyright headers in all modified files.
+Use the current year dynamically and only update files that are already modified.
 
-### Get Current Year
+> The full copyright workflow lives in `reference/copyright-check.md`. Read `reference/copyright-check.md` before editing any header.
 
-```bash
-date +%Y
-```
-
-**Never hardcode the year.**
-
-### Check Modified Files
-
-```bash
-git status --short
-```
-
-### For Each Modified File
-
-Check if the file has a copyright header:
-```bash
-grep "Copyright.*[0-9]\{4\}" <modified_file>
-```
-
-If it has a copyright header and the year is not current, update the year.
-
-**Common formats**:
-- `Copyright (C) 2024-2025` -> `Copyright (C) 2024-{CURRENT_YEAR}`
-- `Copyright (C) 2024` -> `Copyright (C) 2024-{CURRENT_YEAR}`
-- `Copyright (C) 2025` -> `Copyright (C) {CURRENT_YEAR}` (if already current)
-
-### Copyright Checklist
-
-Before executing `git commit`:
-- [ ] Used `date +%Y` to dynamically get the current year
-- [ ] Checked all files about to be committed
-- [ ] Updated copyright year in all files that have copyright headers
-- [ ] **Never** hardcoded the year
-- [ ] **Only** updated modified files, not the entire project
-
-## Step 2: Analyze Changes and Generate Commit Message
-
-```bash
-git status
-git diff
-git log --oneline -5
-```
-
-Generate commit message in Conventional Commits format:
-- `<type>(<scope>): <subject>` (English imperative mood, max 50 chars)
-- Body: 2-4 bullet points explaining what and why
-- Signature block:
-  - `Co-Authored-By: {Your Model Name} <noreply@provider.com>`
-  - If task-related, append extra `Co-Authored-By` lines for other contributing agents
-
-### Multi-Agent Co-Authorship (If Task-Related)
-
-If the commit belongs to an active task and `.agents/workspace/active/{task-id}/task.md` exists:
-
-1. Read the `## Activity Log` section from `task.md`.
-2. Extract all unique agent names from entries matching `by {agent}`. A loose pattern such as `by (\S+)` is acceptable.
-3. Exclude `human` because the Git author is already the human user.
-4. Map each agent to a `Co-Authored-By` line:
-
-| Agent | Signature |
-|-------|-----------|
-| `claude` | `Co-Authored-By: Claude <noreply@anthropic.com>` |
-| `codex` | `Co-Authored-By: Codex <noreply@openai.com>` |
-| `gemini` | `Co-Authored-By: Gemini <noreply@google.com>` |
-| `opencode` | `Co-Authored-By: OpenCode <noreply@opencode.ai>` |
-
-5. Build the signature block with these rules:
-   - Keep the current executing agent's signature in its original position.
-   - Append other unique participating agents as additional `Co-Authored-By` lines.
-   - Do not duplicate the current agent if it already appears in `Activity Log`.
-   - For unknown agent names, use `Co-Authored-By: {Agent} <noreply@unknown>`.
-
-If the commit is not task-related, keep the existing single-signature behavior.
-
-## Step 3: Create Commit
+## 3. Build the Commit Message
 
-```bash
-git add <specific-files>
-git commit -m "$(cat <<'EOF'
-<type>(<scope>): <subject>
+Review status, diff, and recent history, then prepare a Conventional Commit with the correct co-author lines.
 
-- <bullet point 1>
-- <bullet point 2>
+> Commit message rules, examples, and multi-agent co-authorship details live in `reference/commit-message.md`. Read `reference/commit-message.md` before writing the commit.
 
-Co-Authored-By: {Your Model Name} <noreply@provider.com>
-<additional Co-Authored-By lines for other task participants, if any>
-EOF
-)"
-```
+## 4. Create the Commit
 
-**Important**:
-- Add specific files by name - do NOT use `git add -A` or `git add .`
-- Do NOT commit files that may contain secrets (.env, credentials, keys)
-- For task-related commits, keep the current agent first and append the extra lines generated above
+Stage specific files only and run `git commit` with the prepared message.
 
-## Step 4: Update Task Status (If Task-Related)
+## 5. Update Task Status When Applicable
 
 Get the current time:
 
@@ -141,93 +42,20 @@ Get the current time:
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-After committing, update task status based on the situation:
-
-For all cases below, **append** to `## Activity Log` in task.md (do NOT overwrite previous entries):
-```
-- {yyyy-MM-dd HH:mm:ss} — **Commit** by {agent} — {commit hash short} {commit subject}
-```
-
-> **⚠️ Situation Check — you must inspect task state first, then choose exactly one matching case below:**
->
-> - Check `task.md` for `current_step`, workflow progress, and the latest `## Activity Log` entry
-> - Check whether the latest `review.md` / `review-r{N}.md` exists and whether the latest review passed with no issues
-> - Check whether any follow-up repair, review, or PR creation step is still pending
->
-> | Decision basis | Required case |
-> |---------------|---------------|
-> | All workflow steps complete + latest review passed with no issues + all tests pass | Case 1: Final Commit |
-> | There are still incomplete steps, unresolved fixes, or waiting actions | Case 2: More Work Needed |
-> | The purpose of this commit is to send the implementation/refinement into code review | Case 3: Ready for Review |
-> | Code is committed, review is done, and the next action should be PR creation | Case 4: Ready for PR |
->
-> **Do not mix multiple cases. You must decide first, then output the single matching next step.**
-
-### Case 1: Final Commit (Trigger: all work is done and the next step is task archival)
-
-If this is the last commit and all work is done:
-
-Prerequisites:
-- [ ] All code committed
-- [ ] All tests pass
-- [ ] Code review passed
-- [ ] All workflow steps complete
-
-Suggest next step:
-
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
-
-```
-Next step - complete and archive the task:
-  - Claude Code / OpenCode: /complete-task {task-id}
-  - Gemini CLI: /{{project}}:complete-task {task-id}
-  - Codex CLI: $complete-task {task-id}
-```
-
-### Case 2: More Work Needed (Trigger: incomplete steps, unresolved issues, or pending collaboration remain)
+> The full four-case status matrix, prerequisite checks, and multi-TUI next-step commands live in `reference/task-status-update.md`. Read `reference/task-status-update.md` before updating task state.
 
-If there's follow-up work (awaiting review, more fixes needed):
-- Update `task.md`: set `updated_at` to current time
-- Record this commit's content and next steps in task.md
+Append the Commit Activity Log entry and choose exactly one next-step case:
+- final commit -> `complete-task {task-id}`
+- more work remains -> update task.md and stop
+- ready for review -> `review-task {task-id}`
+- ready for PR -> `create-pr`
 
-### Case 3: Ready for Review (Trigger: the next action should be `review-task`)
-
-If the commit is ready for code review:
-- Update `task.md`: set `current_step` to `code-review`
-- Update `task.md`: set `updated_at` to current time
-- Mark implementation step as complete in workflow progress
-
-Suggest next step:
-
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
-
-```
-Next step - code review:
-  - Claude Code / OpenCode: /review-task {task-id}
-  - Gemini CLI: /{{project}}:review-task {task-id}
-  - Codex CLI: $review-task {task-id}
-```
-
-### Case 4: Ready for PR (Trigger: the next action should be `create-pr`)
-
-If the commit should become a Pull Request:
-- Update `task.md`: set `updated_at` to current time
-- Record PR plan in task.md
-
-Suggest next step:
+## Notes
 
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
+- Never commit secrets such as `.env`, credentials, or keys
+- Keep the current agent first in the co-author block
+- Do not use `git add -A` or `git add .`
 
-```
-Next step - create a Pull Request:
-  - Claude Code / OpenCode: /create-pr
-  - Gemini CLI: /{{project}}:create-pr
-  - Codex CLI: $create-pr
-```
-
-## Notes
+## Error Handling
 
-- Do NOT commit files containing sensitive information (.env, credentials, etc.)
-- Ensure commit messages clearly describe the changes
-- Follow the project's Conventional Commits conventions
-- If task status update fails, warn the user but do not block the commit
+- If the task status update fails, warn the user but do not block the commit