agile-development

Agile Development 2.0

Sixteen tools on rm_* and pm_*. This is the plugin-provided Agile module (com.snc.sdlc.agile.2.0), not a generic task tracker — the tables are its own and the state values are numbers behind friendly labels.

Is the plugin even on?

Every table here comes from the plugin. If it is not activated, calls fail with "Invalid table", and the tools say so with the plugin id rather than passing the raw error through. Cheapest check — a read that needs no ids:

await snow_agile_sprint_query({ limit: 1 })   // touches rm_sprint

An instance without the plugin has none of this and no amount of retrying helps.

The model

rm_team          a scrum team, with a default velocity
  └── rm_team_member    one person on it, with a role
rm_sprint        a time box, optionally assigned to a team
rm_epic          a body of work spanning sprints
  └── rm_story        the unit of work. Points, state, assignee.
       └── rm_scrum_task   optional breakdown under a story
rm_release       groups sprints and epics for a ship date

Separately, pm_project / pm_project_task is PPM, a different product: waterfall-ish projects with a manager and dates. snow_create_project and snow_create_project_task write there. Do not mix them with the rm_* tables — a story is not a project task and nothing joins them.

Order of operations

Team → sprint → story. Every link is a reference lookup that fails if the target is not there yet.

// 1. team
const team = await snow_agile_team_manage({ action: "create", name: "Platform", velocity: 30 })
await snow_agile_team_manage({ action: "add_member", sys_id: team.sys_id,
                               member: "sam.patel", role: "scrum_master" })

// 2. sprint — the team is resolved by name or sys_id
await snow_agile_sprint_manage({ action: "create", name: "Sprint 24", team: "Platform",
                                 start_date: "2026-09-01", end_date: "2026-09-14", story_points: 30 })

// 3. stories, attached at creation or later
await snow_agile_story_manage({ action: "create", title: "Widen the assignment lookup",
                                story_points: 5, sprint: "Sprint 24", state: "Ready" })