Skip to content

Feature-flag policy as workspace default: AGENTS.md rule, skill updates, flagged labels #21

Description

@ElbertePlinio

Make the flags-not-megabranch pattern (pickforge/pickforge#152, @pickforge/flags from #10) a workspace-wide default policy instead of a per-epic rule, so multiple in-flight features stay trackable from merge to release.

The rule being codified (decision rule, not "always flag"):

  • Flag a feature when it merges to main before the release that enables it (multi-PR, spans releases, or held back).
  • Skip the flag when the feature ships in the next release anyway — the release tag is the switch.
  • Flags come from @pickforge/flags, default-off; enabling = shipping a new default.
  • Flag removal is part of the feature, not optional cleanup.

Checklist

  • Workspace AGENTS.md: canonical "Feature flags" section (other docs reference it, never restate)
  • plan-issue skill: flagged-feature lifecycle checklist (merged behind flag → tested on main → enabled in vX.Y.Z → flag removed)
  • kickoff skill: flag-or-not decision at planning time, recorded in the issue
  • release skill (this repo): note which flags the version flips; check for stale flags shipped enabled earlier → PR
  • flagged label in pickforge, pickscribe, pickgauge, picklab

Validation

  • gh label list shows flagged in all four app repos
  • Release-skill PR through the normal review loop

Note: plan-issue/kickoff skills and workspace AGENTS.md live outside tracked repos — those edits are direct, recorded here. Only the release skill change gets a PR.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions