{
  "markdown": "# Project Notion Plugin\n\nA Claude Code plugin for Notion task management workflow. Provides skills for brainstorming, planning, and implementing tasks directly in Notion.\n\n## Installation\n\n### Option 1: Local Development\n```bash\nclaude --plugin-dir ./project-notion\n```\n\n### Option 2: Marketplace (when published)\n```bash\n/plugin install project-notion\n```\n\n## Skills\n\nThis plugin provides the following namespaced skills:\n\n| Skill | Command | Description |\n|-------|---------|-------------|\n| Brainstorm | `/project-notion:brainstorm` | Brainstorm and create multiple task pages in Notion |\n| Plan Task | `/project-notion:plan-notion-task` | Create detailed implementation plan for a task |\n| Implement Task | `/project-notion:implement-notion-task` | Implement a task using code-writer agents |\n| Init Project | `/project-notion:init-project-notion` | Initialize a new Notion-Claude Code project |\n\n## Setup\n\n### 1. Initialize PROJECT-NOTION.md\n\nBefore using the skills, you need to create a `PROJECT-NOTION.md` file in your project root:\n\n```yaml\n---\nnotion-project-id:\n  Your Project=your-project-page-id\nmilestone-in-projects:\n  MVP V1=your-milestone-page-id\n  Phase 2=your-milestone-2-id\ncurrent-milestone:\n  MVP V1=your-milestone-page-id\nproject-description:\n  Your project description here\ngithub-repository:\n  https://github.com/your-repo\n---\n```\n\n### 2. Get Notion Page IDs\n\nTo get a Notion page ID:\n1. Open the page in Notion\n2. Copy the URL: `https://www.notion.so/workspace/Page-Name-pageId`\n3. The page ID is the 32-character string at the end (without hyphens)\n\n### 3. Verify Connection\n\nRun the init skill to verify your Notion connection:\n```\n/project-notion:init-project-notion\n```\n\n## Workflow\n\n### Standard Task Flow\n\n1. **Brainstorm** (`/project-notion:brainstorm`)\n   - Describe your idea\n   - Get clarifying questions\n   - See drafted tasks\n   - Tasks are written to Notion\n\n2. **Plan** (`/project-notion:plan-notion-task`)\n   - Select a task from Notion (or create new)\n   - Enter plan mode for detailed analysis\n   - Add implementation steps + acceptance criteria\n   - Optionally create Test sub-task for UAT\n\n3. **Implement** (`/project-notion:implement-notion-task`)\n   - Code-writer agent implements the code\n   - (Optional) Tester agent verifies via Playwright\n   - Ask for commit confirmation\n   - Mark task Done after successful push\n\n## Project Structure\n\n```\nproject-notion/\n├── .claude-plugin/\n│   └── plugin.json          # Plugin manifest\n├── skills/\n│   ├── brainstorm-notion-task/\n│   │   └── SKILL.md         # Brainstorming skill\n│   ├── plan-notion-task/\n│   │   ├── SKILL.md         # Planning skill\n│   │   └── references/\n│   │       └── context.md   # Notion schema docs\n│   ├── implement-notion-task/\n│   │   ├── SKILL.md         # Implementation skill\n│   │   └── references/\n│   │       └── context.md   # Notion schema docs\n│   └── init-project-notion/\n│       ├── SKILL.md         # Init wizard skill\n│       └── references/\n│           └── context.md   # Notion schema docs\n└── README.md\n```\n\n## Notion Database Schema\n\nThe skills expect the following Notion database structure:\n\n- **Projects** (top-level page)\n- **Milestones** (under Projects)\n- **Tasks** (database with relation to Milestones)\n\nSee `skills/*/references/context.md` for detailed schema documentation.\n\n## Configuration\n\n### Dynamic IDs\n\nAll Notion IDs are read from `PROJECT-NOTION.md` at runtime. No hardcoded IDs.\n\n### Status Workflow\n\nTasks follow this status flow:\n1. `Not started`\n2. `Planning`\n3. `In progress`\n4. `Waiting for Testing`\n5. `Waiting for Review`\n6. `Done`\n\n## Troubleshooting\n\n### \"PROJECT-NOTION.md not found\"\nRun `/project-notion:init-project-notion` to create the configuration file.\n\n### Skills not appearing\nRun `/reload-plugins` to refresh the plugin.\n\n### Notion API errors\nVerify your Notion MCP is configured and you have access to the pages.\n\n## License\n\nMIT\n",
  "bytes": 3909,
  "sha": "6a37a87d3efe43d5c70b4191b0bb96bbf8f50e1d4ecd2b77979eab440c2a36bf",
  "repo_slug": "arzitech/project-notion",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_arzitech_project_notion_project_notion_e3737df2/readme"
}