An AI-augmented agile planning kit for development teams. It combines portable skills (prompt chains with human approval), a Notion hub (backlog, DoR, planning, metrics), and manual export to Jira or Trello.

Developed as part of a Descomplica Extension Project (PEX), aligned with SDG 9 (Industry, innovation and infrastructure). The pilot documents applying the kit to a software development project run by RODRIGO HERPICH MULLER LTDA.

Everything you need to use 3APK lives in kit/:

Principles:

• Human-in-the-loop — no estimate or acceptance criterion enters the sprint without explicit team approval.
• LLM-agnostic — Markdown skills; work in Cursor, Claude, ChatGPT, Copilot Chat, etc.
• No new SaaS — Notion + your existing tools; manual export to Jira/Trello.

Detailed index: kit/README.md.

• Notion account (free tier)
• Any LLM chat or IDE with an agent
• Jira or Trello (optional) — to carry the sprint plan into execution
• ~30 minutes to set up Notion following the guide

Not required: server, API, build step, or a specific tool subscription.

Follow kit/notion/SPEC.md and create the four databases:

1. Backlog — stories, DoR, status
2. Sprints — capacity, dates
3. Planning Worksheet — sprint commitment (view: DoR-approved only)
4. Metrics — KPIs per sprint

Fields must follow the schemas in kit/notion/schema/.

Option A — Skills CLI (Cursor and other agents)

From the repository root, after cloning:

# list available skills
npx skills add ./kit/skills --list

# install all five (project scope)
npx skills add ./kit/skills --agent cursor --all -y

# install one skill
npx skills add ./kit/skills --agent cursor --skill 3apk-refine-story -y

# install globally (available in every project)
npx skills add ./kit/skills --agent cursor --all -g -y

From GitHub (no local clone):

npx skills add iwilldotdev/3apk --agent cursor --all -y

Skills reference kit artifacts (schemas, exports, fixtures). Install from a clone of this repo when you need those relative links to resolve. Discover more skills at skills.sh.

Option B — Manual

Copy folders from kit/skills/ to where your agent reads skills, or attach the SKILL.md in chat:

• CSV columns: kit/exports/COLUMNS.md
• Jira: kit/exports/jira-recipe.md
• Trello: kit/exports/trello-recipe.md
• Other tools: kit/exports/generic-fallback.md

Reference: kit/fixtures/sample-worksheet-export.csv.

Use the examples in kit/fixtures/ and run:

python3 kit/fixtures/validate_fixtures.py
python3 kit/exports/test_export_recipes.py

One skill at a time, with human approval before moving on:

Raw request
  → 3apk-refine-story    → approve user story
  → 3apk-refine-ac       → approve acceptance criteria
  → 3apk-refine-estimate → approve estimate range (hint)
  → 3apk-refine-risks    → approve deps/risks + DoR
  → paste into Notion    → DoR_Pass or DoR_Fail

• One question per message (multiple choice when possible).
• The AI does not set the final estimate — the team adjusts during planning.
• Items that fail DoR do not enter the sprint.

Examples: kit/fixtures/refine-story-example.md and other refine-*-example.md files.

1. Open the Sprint Candidates view in Notion (DoR_Pass only).
2. Register the sprint in Sprints with capacity_hours.
3. Invoke 3apk-plan-sprint with stories + capacity.
4. Fill human_adjustment_log for every changed estimate.
5. Approve the sprint draft (Sprint Lock).
6. Export CSV and import into Jira/Trello.

Example: kit/fixtures/plan-sprint-example.md.

After each sprint, add one row in Metrics:

Full schema: kit/notion/schema/metric-snapshot.json.

3APK/
├── kit/
│   ├── skills/       # 5 modular skills
│   ├── notion/       # SPEC.md + JSON Schemas
│   ├── exports/      # COLUMNS.md + Jira/Trello recipes
│   └── fixtures/     # JSON/CSV examples
└── README.md

• Descomplica PEX Guide (Portuguese)
• SDG 9 — Industry, innovation and infrastructure (UN)

University extension material and an open kit for adaptation by any team. When reusing, keep the human-approval protocol at every refinement step.