キーコンセプト
SpecDownのコア構築要素を理解すれば、プラットフォームを最大限に活用できます。
プロジェクト
プロジェクトはドキュメントの最上位コンテナです。リポジトリのように考えてください — すべてのドキュメントを保持し、アクセス制御を管理し、Git同期設定を追跡します。
各プロジェクトには共有リンクやCLIで使われる一意のスラッグ（例: my-api-docs）があります。 異なるチームや製品で複数のプロジェクトを持つことができます。
ドキュメント & フォルダ
ドキュメント
タイトル、コンテンツ、プロジェクト内の一意パスを持つMarkdownファイル。
フォルダ
関連ドキュメントをまとめるコンテナ。フォルダは任意の深さまでネスト可能。
すべてのドキュメントとフォルダにはguides/api/authenticationのようなfull_pathがあります。 このパスはGit同期、CLI、共有リンクで使用されます。
ロール & 権限
SpecDownはプロジェクトレベルでロールベースアクセス制御（RBAC）を使用します。 プロジェクトの各メンバーには5つのロールのいずれかが割り当てられます：
| ロール | 閲覧 | 編集 | メンバー管理 | プロジェクト削除 |
|---|---|---|---|---|
| Owner | ✓ | ✓ | ✓ | ✓ |
| Admin | ✓ | ✓ | ✓ | ✗ |
| Editor | ✓ | ✓ | ✗ | ✗ |
| Viewer | ✓ | ✗ | ✗ | ✗ |
| Public | リンク経由 | ✗ | ✗ | ✗ |
ロールは行レベルセキュリティによりデータベースレベルで強制されます — 直接APIアクセスでもこれらの権限が適用されます。
共有リンク
すべてのドキュメントはトークンベースの共有リンクで共有できます。共有ドキュメントを読むのにSpecDownアカウントは不要です。
| タイプ | プラン | 説明 |
|---|---|---|
| 公開 | Free | リンクを持っている誰でも閲覧可能 |
| パスワード保護 | Pro | 閲覧者はパスワード入力が必要 |
| 期限付き | Pro | 指定日後にリンクは自動失効 |
バージョン履歴
ドキュメントを保存するたびに、SpecDownは自動的にバージョンスナップショットを作成します — ただし、コンテンツが変更された場合のみ（SHA-256ハッシュで検出）。同じ保存の重複でバージョン履歴が肥大化することを防ぎます。
バージョン履歴は Pro とTeam プランで利用できます。
プラン概要
Free
1プロジェクト、10ドキュメント、公開共有リンク
Pro
無制限ドキュメント、Git同期、MCP、バージョン履歴
Team
Proの全機能 + チームメンバー、コメント、管理