Cognoこのガイドは、新しい workspace を使える状態にするための最短手順です。メンバーが入れる、タスクの置き場所が決まっている、必要な連携が接続されている、設定の場所がわかる状態を目指します。
前提
- Cogno account がある。
- workspace を作成または管理できる権限がある。
- Cogno に扱わせたい元情報がある。例: tasks、issues、meetings、documents、connected apps。
最初のセットアップ手順
- Cogno app に sign in します。
- workspace を作成するか、workspace selector から既存 workspace を開きます。
- Settings > Members を開き、workspace に入るメンバーを招待します。
- Tasks で手動作成するか、Settings > General > Task import から既存タスクCSVをインポートします。
- Integrations を開き、workspace context に使うサービスを接続します。
- Settings > Memory を開き、Cogno に常に読ませたい安定した workspace facts を書きます。
- local worker を使う場合は Settings > API Keys で key を作成し、CLI worker を起動します。
Workspace basics
Cogno の作業は workspace 内で行います。主な navigation は次の通りです。
| Area | Use it for |
|---|---|
| Tasks | 現在の作業、import した tasks、saved views、status changes、assignees、due dates、project links。 |
| Inbox | 未読 task comments と mentions。 |
| Meetings | meeting records と Google Calendar notetaker activity。 |
| Projects | project 単位の task organization。 |
| Integrations | GitHub、Slack、Notion、Google Calendar、Discord、Microsoft Teams、今後追加される source apps。 |
| Settings | workspace identity、members、memory、API keys、workers、activity、import、delete controls。 |
Tasksを追加する
チーム全体で使う前に、タスクの source of truth を決めます。
| Situation | Recommended action |
|---|---|
| 新しく始める | Tasks で少数の tasks を手動作成します。 |
| 既存タスク管理ツールから移す | task CSV を export し、Settings > General > Task import から import します。 |
| 元の文脈を残したい | source URLs、issue keys、labels、milestones、custom fields を import metadata として残します。 |
| 担当者も移したい | import 前に members を招待し、import 時に source assignees を mapping します。 |
Task CSV import は Linear、Notion databases、GitHub CLI 経由の GitHub Issues、Asana projects、Jira Cloud exports に対応します。詳しくは タスクCSVをCognoにインポートする を見てください。
Membersを招待する
Settings > Members を開きます。
| Action | Result |
|---|---|
| Invite | member invite options を開きます。 |
| Copy invite link | チームメイトに共有できる invite link を作成します。 |
| Add existing members | 他の workspace で既に使っている人を追加します。 |
| Edit | owner が削除可能な non-owner member を削除できます。 |
CSVに assignees または collaborators が含まれる場合は、import 前に members を追加してください。
Integrationsを接続する
Integrations を開き、workspace に必要な apps を接続します。
| Integration | Use it for |
|---|---|
| GitHub | pull request、commit、issue workflows。 |
| Slack | workspace conversations と messages からの task creation。 |
| Notion | pages と database context。 |
| Google Calendar | Google Meet notetaker activity 用の per-user calendar connection。 |
| Discord | server、channel、message context。 |
| Microsoft Teams | 有効な workspace での team communication workflows。 |
Google Calendar は各 member が自分の account を接続します。workspace には複数 member の接続状態が表示されます。
Memoryを書く
Settings > Memory を開き、Cogno が起動時に読む安定情報を書きます。
- workspace が何を作っているか。
- product areas と owners。
- 現在の operating priorities。
- canonical として扱う links や naming conventions。
- tasks や meetings をまたいで守る rules。
Memory は管理できる短さに保ちます。Markdown headings と lists を使ってください。
Workersを設定する
Cogno workers は、browser session なしで local / external worker daemon を認証するために使います。
- Settings > API Keys を開きます。
- key を作成します。
- raw key をその場でコピーします。
- 次を実行します。
cogno login --token <key>
cogno
Settings > Workers で liveness と recent agent work を確認します。worker が2分以内に heartbeat を送らない場合は stale、その後 offline と表示されます。
Setup checklist
日常利用に入る前に確認します。
| Check | Done when |
|---|---|
| Workspace identity | name と icon が見分けやすい。 |
| Members | 必要な人が workspace に入れる。 |
| Tasks | 現在の作業が Cogno にある。手動作成または import 済み。 |
| Source traceability | imported tasks に source URLs または external IDs が残っている。 |
| Integrations | 必要な apps が期待する connection state になっている。 |
| Memory | workspace facts が短く、最新で、読みやすい。 |
| Workers | 必要な場合、local worker setup が Settings > Workers に表示される。 |
LLM handoff
assistant にセットアップを手伝わせる場合は、次を渡します。
- workspace name
- member roles または teammate list
- 接続したい source apps
- task source: manual entry または CSV import
- worker / API key の必要性
Copy for LLM を使うと、この setup path と Cogno 用語をそのまま渡せます。