操作手順

完全なユーザーガイドです。概念についてははじめにを参照してください。

アカウント

サインアップとサインイン

eastagiletracker.com/register でメールアドレスとパスワードを使って登録するか、OAuth を使いたい場合は continue with GitHub を選択します。送信されるリンクからメールアドレスを認証してください。認証が完了するまではサインインできますが、一部の機能が制限されます。

プロジェクトまたは組織に招待されている場合は、招待メールのリンクをたどってください。アカウントが作成され（またはサインインし）、該当するボードに直接たどり着きます。

パスワードをお忘れですか？サインインページの Forgot Password を使ってください。リセットリンクをメールでお送りします。

アカウント設定

右上のアバター → Account Settings から:

Profile — 表示名、イニシャル（オーナーアバターに使用）、メールアドレス。
Bio — 短い自己紹介（最大 4 KiB）。/me や組織メンバー一覧に表示され、エージェント（またはチームメイト）が適切な相手を選んで尋ねられるようにします。オプトアウトするには空白のままにします。
Password — いつでも変更できます。
Avatar — 画像をアップロードするか、イニシャルにフォールバックします。
API Keys — 個人用 API トークンを作成します。API ガイドを参照してください。
Theme — Agile、Labs、Dark、Light（サイドバーからも切り替え可能）。
Delete Account — 2 段階の確認。すべての組織とプロジェクトから削除されます。

セキュリティ

右上のアバター → Security から:

Two-factor (TOTP) — 任意の認証アプリ（1Password、Authy、Google Authenticator、…）でコードを設定します。10 個の一回限りのリカバリーコードを取得できます。これらは一度だけ表示されるので保存してください。後で現在のコードまたはリカバリーコードで無効化できます。
Passkeys — デバイスにバインドされた WebAuthn パスキー（Touch ID、Windows Hello、ハードウェアセキュリティキー）を追加します。以降はパスワードなしでサインインできます。同じページからキーの追加、名前付け、削除が行えます。

セッションとリフレッシュトークン

サインインに成功すると 2 つのトークンが発行されます。短命の access JWT と長命の refresh token（30 日、使用のたびにローテーション）です。SPA はアクセストークンが期限切れになると自動的にリフレッシュします。リフレッシュトークンが期限切れになるか、サインアウトするまでサインイン状態が維持されます。サインアウトするとリフレッシュトークンがサーバー側で取り消されるため、盗まれたコピーを再利用することはできません。

課金

ほとんどのアカウントは個人利用において Free Forever です。アカウントにメーター制のクレジット残高がある場合は、Account → Billing で確認できます。Paddle のチェックアウトでチャージし、取引履歴を確認できます。

組織

すべてのアカウントは 1 つ以上の組織に所属します。新規にサインアップすると、Linear/Vercel 風に個人用組織（「<Name> Org」）が自動作成されます。プロジェクトは組織の中に存在し、組織のメンバーシップがプロジェクトのメンバーシップのゲートとなります。

組織を切り替える

トップバーの org switcher をクリックすると、所属する組織を切り替えられます。アクティブな組織はサイドバーに色を付け、「Projects」一覧のスコープを決め、新しいプロジェクトを作成する際にあらかじめ選択されます。

組織を管理する（管理者）

サイドバーの組織ブロック → Manage organization をクリックすると /organization/{id}/projects にたどり着きます。サイドバーには 3 つの管理タブが表示されます。

Projects — この組織内のすべてのプロジェクト。
Members — 現在のメンバー、ロール、保留中の招待。メールで招待できます。招待はメールアドレスに固定され、TTL 付きのトークンとロールの上限を持ちます（メンバーは管理者を招待できません）。
Settings (オーナーのみ) — 組織名、スラッグ、プラン。ここで別のメンバーに所有権を移譲します。

メンバーを削除する

組織からメンバーを削除すると カスケード します。その組織のプロジェクトにおけるプロジェクト単位のメンバーシップが、同じトランザクション内で取り消されます。ブックマークされたボード URL は、組織へのアクセスを失った瞬間に動作しなくなります。孤立した痕跡は残りません。

プロジェクト

プロジェクトを作成する

Projects ページから New Project をクリックします。作成フォームでは 2 つのことだけを尋ねられます。

Title — 必須。
Description — 任意。すべてのメンバーに表示されます。

その他のすべて（イテレーションの長さ、開始日、初期ベロシティ、見積もりスケール、done 状態、タスクのトグル）は後で Project Settings で設定され、妥当なデフォルト値がシードされます。

プロジェクト設定

プロジェクトの Settings メニューの下に 4 つのタブがあります。

Project — タイトル、説明、イテレーションの長さと開始日、ベロシティ戦略（直近 3 / 5 / 10 件の平均）、done 状態、見積もりスケール、タスクのトグルを編集します。
Member — 人間のメンバーの招待、昇格/降格、削除を行います（下記の メンバーと招待 を参照）。
Agent — このプロジェクトのエージェント API キーを発行・取り消しします（下記の エージェント を参照）。オーナーのみ。
Import — 別のトラッカーからストーリーを取り込みます（下記の 他のトラッカーからのインポート を参照）。

メンバーと招待

Project Settings の Member タブで、人間をメールで招待します。保留中の招待は、承諾されるまで別のバケットに置かれます。誰が招待されているかが分かり、再送または取り消しができます。アクティブなメンバーは viewer、member、owner の間で昇格/降格できます。オーナーはプロジェクト設定を変更でき、ビューアーは読み取りはできますが書き込みはできません。

プロジェクト履歴は専用ページにあります。プロジェクト設定のすべての変更、すべてのメンバーシップの変更が、実行者（人間またはエージェント）とともに記録されます。

ストーリー

ストーリーを作成する

任意のボードパネル（Current、Backlog、Icebox、またはカスタムのもの）の + Add story を使い、タイトルを入力して Enter を押します。

Current で作成された新しいストーリーは、デフォルトで current_state = 'unstarted' になります。これは PT と同等の挙動です。Current イテレーションは状態による分割ではなく、作業の計画です。オーナーは作業を始めるときにストーリーを明示的に Start します。サイクルタイムの計測はその時まで始まりません。

必須: タイトル。タイプを選択します（デフォルトは feature）。説明、見積もり（feature のみ）、ラベル、オーナー、フォロワー、ブロッカーを追加できます。これらはいずれも後から詳細パネルで入力できます。

Enter を素早く 2 回押した？問題ありません。ボタンはガードされており、ストーリーはちょうど 1 つだけ作成されます。

feature を見積もる

feature はポイントを取る唯一のタイプです。カード（または詳細パネル）のポイントの円をクリックし、スケールから選びます。未見積もりの feature は空白の円で表示されます。

Fibonacci scale — 0, 1, 2, 3, 5, 8, 13。標準的な XP。13 より大きいものはより小さなストーリーに分割すべきです。
East Agile scale — 0, 1, 2, 3。よりタイト。3 は一人分の作業のイテレーション 1 回分を意味します。3 を超えるものは収まりません。
3-Point scale — 1, 2, 3（Small / Medium / Large）。厳密な T シャツサイズ方式。ゼロのオプションも半ポイントもありません。

スケールは Project Settings で一度選びます。後で変更できます（既存の見積もりは横断的にマッピングされます）。

状態を進める

ストーリーをライフサイクルに沿って進める方法は 3 つあります。

カードのインラインアクションボタンをクリック — Start、Finish、Deliver、Accept、Reject。ボタンのテキストは、そのストーリーのタイプにとって次に有効な状態を反映します。
カードをドラッグ して別の列へ。システムは、その列をまたぐことが含意する遷移を適用します。後退する移動には確認を求めます。
一括遷移 — 複数のストーリーを選択し、Transition all を実行すると、各ストーリーが独立して遷移します。1 つが不正であっても、他のものは引き続き処理されます。

詳細パネル

ストーリーの行のどこかをクリックすると、インラインで展開されます。詳細パネルには以下が表示されます。

タイトル（編集可能）、説明（Markdown）、タイプ、見積もり、依頼者。
オーナー（メンバーまたはエージェントの追加/削除）、フォロワー、ラベル。
タスク（有効な場合）、コメント、添付ファイル、ブロッカー、リンク、レビュー。
複製、削除、その他のあまり一般的でない操作のための 3 点メニュー。

Escape を押すと、最後に開いたストーリーが閉じます（スタックを記憶しており、一度に 1 つずつ折りたたみます）。

最大 10,000 文字、Markdown でレンダリングされます。自分のコメントは編集・削除できます。監査ログが履歴を保持します。@ でメンバーをメンションすると、オートコンプリートが拾います。

添付ファイル

ファイルを詳細パネルにドラッグするか、アップロードボタンを使います。1 ファイルあたり最大 2 GB で、そうです、画面録画の動画ウォークスルーにも十分な大きさです。インラインの動画プレーヤーを使用します。

ラベル

サイドバーの Labels ページから、名前と色を付けてラベルを作成し、古くなったらアーカイブします（アーカイブされたラベルはボードから消えますが、検索可能なまま残ります）。ストーリーごとのラベルは詳細パネルで追加します。

ブロッカー、リンク、レビュー

Blockers — 「これは X によってブロックされている」という自由記述のメモ。解決済み/未解決をマークします。has:blocker でボードをフィルタリングします。
Links — 6 つの関係タイプ: relates to、duplicates、blocks、is blocked by、pull request、branch。GitHub の URL を貼り付けると、タイプが自動検出されます。
Reviews — レビュアー（人間またはエージェント）にステータス（pending、approved、rejected）と任意のコメントを付けて割り当てます。

タスク

Project Settings で有効にすると、ストーリーにサブタスク（ストーリー内のチェックリスト）が付きます。進めるごとにチェックを入れます。カードに数が表示されます。

ストーリーフィールドリファレンス

ストーリー詳細画面上のすべての選択変数は、ラベルの隣に小さな [?] アイコンを持ちます。アプリ内でクリックすると、以下にまとめたものと同じガイダンスが表示されます。翻訳者はアプリ内コピーを残りの UI と一緒に提供します。このセクションは長文の正規リファレンスです。

フィールドは Overview タブに現れる順に並んでいます。

Status

ライフサイクルにおけるストーリーの位置: Unstarted → Started → Finished → Delivered → Accepted（または Rejected で Started に戻る）。

重要な状態は Delivered です。エンジニアは delivered とマークしますが、プロダクトオーナーが受け入れ基準に照らして明示的に Accept するまでは完了ではありません。あるいは reject して差し戻します。これにより、受け入れをスプリント終了時のデモまで先送りするのではなく、すべてのストーリーに顧客フィードバックループが組み込まれます。

ストーリーが Delivered に積み上がるなら、それは accept/reject のループが停滞しているシグナルです。すべてのイテレーション終了時に Delivered の件数を見てください。増えているなら、それはプロダクトオーナーのリソースが不足しているか、受け入れ基準が事前に十分明確でないというシグナルです。

Iteration

ストーリーが計画されているイテレーションです。None のままにすると、ストーリーは Backlog に留まり、システムがベロシティに基づいて今後のイテレーションの下に自動的にグループ化します。

ここでの手動オーバーライドは、順序に関係なく特定のイテレーションにストーリーを固定したいときに便利です。例えば、リリースストーリーを固定の日付に結びつける場合などです。それ以外の場合は、Backlog 内の順序にイテレーションの割り当てを任せてください。それがベロシティ予測を正直に保つものです。

Owners

作業をしている人です。オーナーは人間または エージェント のいずれかになり得ます。両者とも監査ログ、コメントの著者、分析において名前付きの参加者としてレンダリングされます。エージェントのオーナーを人間に偽装する方法はありません。

複数オーナーは、ペアプログラミング（またはエージェントとのペア）の可視的な表現 です。ストーリーを取り上げたエージェントとレビューしている人間を追加してください。両方の名前がカードに表示されます。これにより仕掛り作業が低く保たれます。次のストーリーを始める前に終わらせることが、サイクルタイムにとって最大のテコです。

オーナーは Followers（カード上の別フィールド）とは異なります。フォロワーは、ストーリーを 気にかけている が作業はしていない人々で、通常は通知の購読者です。

Story type

4 つのタイプは交換可能ではありません。その区別こそがデータモデルの要点です。

Feature — ユーザーが観察できる新しい価値。ポイントを持ち、ベロシティにカウントされる 唯一の タイプです。これにより、作業をユーザーに見える価値へとスライスすることを強いられます。
Bug — 欠陥。ポイント無し。欠陥はベロシティのクレジットを得ません。これにより、手戻りのコストが報われるのではなく可視に保たれます。
Chore — 直接的なユーザー価値のない必要な作業（リファクタリング、インフラ、セットアップ）。ポイント無し。価値の枠組みを正直に保つため、可能な限り chore を feature にまとめるようチームに圧力がかかります。
Release — マイルストーンのためのゼロポイントのマーカー。Unstarted から Accepted へ直行し、予測のための日付を固定します。

bug や chore にポイントを付けたくなったら: やめてください。それはシステム全体を正直にしている予測を壊します。ベロシティは測定器です。自分の測定器を改ざんしてはいけません。

Priority

可能な限り使わないでください。 Backlog こそが 優先度です。上から下へ、単一の優先度、同点なし。プロダクトオーナーが順序を所有します。

「priority」フィールドは、経験的で順序付けられた Backlog をひそかに希望的計画に戻してしまう、典型的なアンチパターンです。P1 が 3 つあるなら、それは優先度ではありません。順序が間違っている Backlog です。順序を直し、優先度シグナルを削除してください。

このフィールドは、優先度を使うトラッカー（Jira、Asana、…）からのインポートとの互換性のために存在し、インポートされたストーリーが取り込み時に情報を失わないようにしています。新しい作業では「None」のままにしてください。

Points

ストーリーの相対的なサイズです。feature はポイントを取り、bug、chore、release はゼロのままです。

見積もりは サイジングの会話 であり、約束ではありません。ポイントを時間に変換しないでください。速く見せるためにポイントを水増ししないでください。ベロシティは測定器です。自分の測定器を改ざんしてはいけません。

3 つのスケールが提供されます。

Fibonacci — 0, 1, 2, 3, 5, 8, 13。古典的な XP スケール。13 より大きいものは分割すべきです。
East Agile — 0, 1, 2, 3。よりタイトなスケール。3 は一人分の作業のイテレーション 1 回分を意味します。
3-Point — 1, 2, 3（Small / Medium / Large）。厳密な T シャツサイズ方式。

5、8、13 で見積もることが多いなら、ストーリーが大きすぎます。それぞれが 独立してデリバリー可能 になるまで分割してください（INVEST の S と I）。

Requester

ストーリーを依頼した人です。通常は一人で、プロダクトオーナー、ステークホルダー、または誰かに代わって動作するエージェントです。

依頼者はオーナーでは ありません。オーナーは作業をしている人で、依頼者は結果を気にかけ、それを受け入れる（または受け入れない）人です。同じ人であることもありますが、別々のロールです。依頼者を記録することが、6 か月後に 「これを誰が依頼したのか？」 という監査の答えを与えてくれます。

Labels

色付きのタグです。ストーリーは複数持てます。横断的な分類（mvp、tech-debt、security、特定のリリース名）や、ボードのフィルタリング（検索ボックスの label:mvp、またはカスタムフィルターパネルとして保存）に使います。

ラベルは プロジェクトにスコープ されています。サイドバーの Labels ページで管理します。古いラベルは削除するのではなくアーカイブしてください。アーカイブは履歴を検索可能に保ちつつ、ボードをすっきりさせます。

Blockers

このストーリーの進行を妨げているものを説明する自由記述のメモです。妨げが解消されたら解決済みとマークします。

ブロッカーは フローのシグナル であり、キューではありません。デイリースタンドアップで表面化させ、別のところで解決してください。ストーリーごとに 1 〜 2 件を超えるオープンなブロッカーが 1 日以上続くなら、計画が間違っています。ストーリーを分割するか、依存関係を変えてください。目標は、Blocked パネルがほとんどの時間ほぼ空であることです。

Description

ストーリーが何であり、完了したことをどう見分けるかです。Markdown。

受け入れ基準はここに書きます。理想的には Given / When / Then の形式にして、受け入れテストに直接マッピングできるようにします。

Given I am signed in as a member
When I click "Add a story" in Current
Then the story is created in state "unstarted"

INVEST は、ストーリーが適切に形成されているかどうかの健全性チェックです。

Independent — 他のストーリーなしでリリースできる。
Negotiable — 凍結された仕様ではなく、意図を捉えている。
Valuable — ユーザーまたはステークホルダーにとって価値がある。
Estimable — チームがサイズを見積もれる。
Small — イテレーションに余裕をもって収まる。
Testable — 実行できる受け入れ基準を持つ。

受け入れ基準が曖昧なまま Backlog の先頭にあるストーリーは、計画のバグ であり、無視してよい将来の問題ではありません。先に進める前に直してください。

一括アクション

ボード上で複数のストーリーを選択します（範囲は shift+クリック、または Select all in panel）。そして:

一括遷移
一括削除
一括複製

ボード

ボードは各プロジェクトのホーム画面です。デフォルトでは 3 つの列があります。

Current — アクティブなイテレーションのストーリー。イテレーションヘッダー（current、次に upcoming、次に closed）でグループ化されます。カードはイテレーションの時系列順に表示され、各カードに状態が見えます。列は状態で分割 されません — それはチームが計画するイテレーションの時系列を壊します。
Backlog — 厳密に順序付けられたキュー。システムはベロシティに基づいて今後のイテレーションを自動グループ化します。プロダクトオーナーが上から下への順序を所有します。スクロールして下に行くにつれて明確さが低下することは許されますが、先頭では決して許されません。
Icebox — 日付のないアイデア。順序なし、見積もりなし。Icebox は墓場であってよいのです。

設定可能なパネル — サイドバーのチェックボックス

サイドバーの Board セクションには、すべてのプリセット列がチェックボックス付きで一覧されます。ボックスにチェックを入れるとその列を表示し、外すと非表示にします。トグルはプロジェクトごと・ユーザーごとに保持されます（GET/PUT /preferences を通じて同期されます）。プリセットは以下のとおりです。

Current Iteration (デフォルトでオン)
Backlog (デフォルトでオン)
Icebox (デフォルトでオン)
Done — Accepted のストーリー。
My Work — 自分がオーナーであるストーリー。
Blocked — 未解決のブロッカーを持つストーリー。
Epics — エピックレベルのロールアップ。
Chat — プロジェクトにスコープされたチャット列。

カスタムフィルターパネル

検索をパネルとして固定します。type:feature label:mvp owner:claire のようなクエリを貼り付けて保存します。列のサイズを好みに合わせて変更でき、幅はセッションをまたいで保持されます。

検索

検索バーは はじめに で説明されているフィルター構文を受け付けます。検索結果は結果パネルに表示されます。いずれかをクリックすると、ボード上のそれにジャンプします。

Current イテレーションのチップ

トップバーには、現在のイテレーション番号、日付範囲、受け入れ済みポイントと計画済みポイントが表示されます。クリックすると Current 列にジャンプします。

イテレーション

システムは、長さと開始日に基づいてイテレーションを自動的に作成します。「開く」または「閉じる」必要はありません。

先を計画するには、ストーリーを Backlog から今後のイテレーショングループにドラッグします。ベロシティを超えるグループは赤くマークされます。さらに先を計画するには Backlog をスクロールします。3 〜 4 イテレーション先まで表示されます。

巻き戻すには、Current 列の過去のイテレーションヘッダーをクリックして、イテレーションレポートにドリルインします。

リリース

リリースは別個のオブジェクトではなく、ストーリータイプです。任意のストーリーを作成するのと同じ方法でリリースを作成します。タイプとして Release を選び、名前（例: v2.4）を付け、出荷する予定のイテレーションにドラッグします。

リリースは Started/Finished/Delivered/Rejected の状態をスキップし、Unstarted から Accepted へ 1 ステップで進みます。出荷したらリリースを Accept します。分析ビューはリリースマーカーを表示します。

分析

Analytics タブ（プロジェクトの上部）では 6 つのレポートが得られます。

Project Overview — ベロシティの傾向、直近イテレーションの KPI、バーンアップ、バーンダウン、累積フロー。
Iteration — 単一のイテレーションにドリルイン: KPI、バーンダウン、状態フロー。
Releases & Burndowns — リリースのタイムライン、リリースごとのバーンダウン。
Story Activity — 誰が何をしたか。実行者、タイプ、日付範囲でフィルタリング可能。
Cycle Time — Started から done 状態までの時間の平均と分布。
Projections — 現在のベロシティで Backlog がいつ完了するかの予測。

エージェント

これはこの製品を際立たせる部分です。エージェント は名前を持つチームメイトですが、AI です。

プロジェクトにエージェントを追加する

プロジェクトの owner（または管理者）である必要があります。Project Settings → Agents を開きます。

Create new agent key。
エージェントに名前を付けます（監査ログ、コメントの著者、オーナーアバターにその名前で表示されます）。
ロールを選びます — viewer（読み取り専用）または member（書き込み可能）。owner ロールは人間に限定されています。
キーは 一度だけ 表示されます。コピーしてください。取得可能な形では保存されません。プレフィックスは ea_agent_… です。

エージェントができること

member ロールのエージェントは、人間のメンバーができることなら何でもできます。

ストーリーの作成、編集、遷移、削除
コメント、ファイルの添付、ラベルの追加、オーナーの設定
ストーリーのオーナーとして自分自身を選ぶ
アクティビティの読み取り、イベントのフォロー

監査ログは、すべての書き込みをエージェントのアイデンティティとともに記録します。エージェントのアクションを人間のアクションのように見せる方法はありません。

エージェントキーを管理する

Project Settings → Agents では、すべてのアクティブなキー、その名前、ロール、最終使用タイムスタンプが表示されます。キーはいつでも取り消せます。エージェントは即座にアクセスを失います。エージェントの過去のアクティビティは監査ログに永久に残ります。

API でエージェントを使う

コード例については API ガイド → Agent keys を参照してください。

他のトラッカーからのインポート

別のツールから移行する場合、8 つ のソース用のインポーターが用意されています。

Pivotal Tracker
Jira
Asana
GitLab
Shortcut
Trello
Linear
Plane

Project Settings → Import から、エクスポート（ほとんどは CSV、Plane は JSON）をアップロードします。ストーリー、オーナー、コメント、ラベル、状態は自動的にマッピングされます。一部のソースはイテレーションも取り込みます。

プレビューで何がインポートされるかが表示されます。不一致（例: プロジェクトにないラベル）があるとプロンプトが出ます。作成するかスキップするか、選択できます。

テーマ

4 つのテーマが提供されます。サイドバーのフッター（または Account Settings → Theme）で切り替えます。

Agile — マーケティングのランディングページのパレット。温かみのある白、深い青のブランドアクセント（#1f6f9f）、彩度の高いストーリータイプのアイコン。スイッチャーの先頭のオプション。
Labs — Pivotal Tracker のパレットを愛情を込めて保存したもの。ダークなクローム、青いトップバー、パステルの列の隙間。オリジナル。
Dark — 純粋にニュートラルなダーク。
Light — 純粋にニュートラルなライト。紙の上のインク。

テーマはセッションをまたいで保持されます。

言語

UI は 15 言語に翻訳されています: 英語、フランス語、ドイツ語、スペイン語、日本語、中国語、韓国語、ポルトガル語、イタリア語、オランダ語、スウェーデン語、デンマーク語、チェコ語、フィンランド語、ポーランド語。サイドバーのフッターから切り替えます。クローム、認証ページ、アカウント/セキュリティ領域、プロジェクト一覧、マーケティングランディングは即座にローカライズされます。ストーリー詳細 / 分析 / 設定のローカライズは追って対応します。

キーボードショートカット

役立つものをいくつか。

Escape — 最後に開いたストーリーを折りたたむ。
インライン入力での Enter — 送信（行は折りたたまれません）。
Shift+クリック — ストーリーを範囲選択。

時間とともに追加されます。現在の一覧はサイドバーの Help を参照してください。

セルフホスティング

East Agile Tracker はオープンソースです。完全なソースは github.com/EastAgile/agile-tracker にあります。クローンしてビルドし、自分のインフラで実行できます。ホスト版と同じ機能セットです。

セットアップについてはプロジェクトの README を参照してください。