Skip to content

HELM 1.0.1 (published) · Content published · Updated

Evidence: provisional synthesis with claim-level labels. Evidence review: .

HELM Product Roadmap

Product Direction

HELM helps product and engineering teams adapt how they work with AI agents: what agents can usefully do, what people should do and own, what people need to learn, and how the team improves together.

The next practical outputs are a small operating kit, shared competencies expressed as observable behaviors, and a useful development-review method. Start with existing tickets, work examples and team conversations. Add an artifact only when it helps someone make a decision.

The initial context remains software product teams using coding agents. Role-independent competencies apply across roles within that context; broader applicability needs its own evidence. Runtime-agent product engineering, function packs and company-wide expansion retain their separate applicability and demand requirements.

The public framework provides guidance and reusable artifacts. HELM Studio remains a separate facilitated implementation service.

Now, Next, and Later

HorizonOutcomeWhat makes it ready
Now — close the releasePublish the 1.0.1 hardening and Updates workCurrent changes committed and reviewed, checks pass for the release commit, tagging/deployment and public smoke tests recorded
Now — clarify expectationsCorrect guidance that affects ownership, maturity, risk and judgments about peopleReplacement wording, evidence, compatibility decisions and migration notes where needed
Next — work practiceSmall operating kit and one documented workflow trialA non-author can use it; the account includes total effort, quality, learning needs, failures and a justified next step
Next — shared competenciesDraft shared definitions, behavioral examples and a cross-role comprehension trialPeople in different roles can understand the expectations and identify relevant evidence
Then — adaptation and developmentTeam adaptation guidance and a trialed Shared Competency Development ReviewEach artifact passes its own trial and produces an actionable responsibility, learning or development decision
Later, if usefulGuided diagnostic, additional evidence and function-specific guidanceDemonstrated user need, an adequate existing method, and capacity to maintain it

The work-practice and shared-competency tracks can start independently. The Phoenix pilot can supply examples; it is not a prerequisite for researching, drafting or testing shared competencies. Workflow results and review-method reliability require different evidence.

Implementation, Validation, and Publication

AreaImplementationValidationPublication
HELM 1.0.0 baselineCompleteBaseline checks recordedPublished as framework-v1.0.0
1.0.1 hardening in PR #11CompleteLocal and GitHub quality/container checks passedReview, merge, tagging and deployment pending
Updates mechanismComplete locallyRegistry, change coverage, generated content and browser checks passed locallyCommit, updated CI and publication pending
Guidance correctionsRegister exists; replacement guidance openAcceptance checks and version impacts still to resolvePending
Workflow kit and pilotPlannedNot yet field-testedPending
Shared competencies and development reviewPlanned belowNo review-method validation claimedPending

Implementation status does not imply field validation or publication. The Updates page records announcements; docs/releases/1.0.1.md records hardening verification. The already implemented version/evidence display, changelog, correction route, navigation and Updates feed are release work, not new expansion features.

Version Baseline and Release Map

Framework releases describe published guidance. The application package has an independent technical version, currently 0.0.1.

Planning targetScope
1.0.0Published baseline, preserved for interpretation and comparison
1.0.1Meaning-preserving hardening and linked updates; candidate awaiting publication
1.1Work Redesign Kit and Pilot, with the guidance corrections it consumes
1.2Shared Competencies and Development, alongside Work, Skills, and Team Adaptation; separately testable and publishable outputs
1.3, conditionalPractical Diagnostic, only when users need help choosing a next action
UnassignedBroader validation, formal performance-rating applicability, function packs and company-level guidance

Shared-competency design starts in the Next horizon even though its publication target is 1.2. Neither 1.2 output requires completion of the other. Freeze each release’s scope from ready, validated work and explicitly move unfinished scope rather than making every artifact a mutual blocker.

Compatibility policy

The compatibility contract covers recommendation meaning, decision rights, assessment interpretation, stable identifiers and artifact contracts.

Labels beyond the baseline are planning targets, not commitments about compatibility or dates. Resolve version impact before publishing each correction. If a breaking change requires 2.0, relabel subsequent targets before scope freeze; a major version does not imply company-wide expansion. Urgent harmful guidance needs a visible qualification or withdrawal while its versioned correction is prepared.

Active Work Tracker

Existing work-item IDs are preserved. Firas owns delivery; actual trial participants and reviewers must be named in the relevant work note before a trial starts. Ready permits work to start once capacity and a specific review date are assigned; it does not assert that a trial is booked.

IDPriorityWork itemTargetStatusOwnerDependency / completion evidence
RM-002P1Refresh roadmap around parallel work practice and shared competenciesPlanningDoneFiras2026-09-17; active roadmap, retained backlog/history, linked update; local content and targeted browser/accessibility checks passed
FND-004P1Complete publication of hardening and Updates1.0.1In reviewFirasPR #11 and release report; include local Updates changes, verify current CI, then record tag/deployment/smoke tests
V11-002P0Resolve credibility-critical guidance and classify correctionsVersion by impactReadyFirasPrioritized dependencies below; evidence and acceptance checks in the correction register
V11-001P1Describe one Phoenix workflow as it works today1.1ReadyFirasNamed workflow and participant; existing work records, owners, effort, learning needs and sharing limits
V11-005P1Agree how to run the workflow pilot1.1BlockedFirasV11-001; record access, ownership, stopping conditions and comparison in the same work note
V11-003P1Test the small operating kit1.1BlockedFirasV11-001 and V11-005; non-author trial, before/after account and retain/revise/reject decision
V11-004P1Publish the approved pilot account1.1BlockedFirasV11-003 and applicable corrections; permission for published details and explicit limitations
COMP-001P1Research and reconcile the shared competency model1.2 design nowReadyFirasResearch-to-competency mapping, existing universal-competency mapping, applicability and compatibility decisions
COMP-002P1Draft Shared Competencies guide and behavior examples1.2BlockedFirasCOMP-001; proposed definitions, observable behaviors, examples and evidence prompts for the planned /competencies page
COMP-003P1Trial competency language and evidence examples across roles1.2BlockedFirasCOMP-002; non-author feedback from different roles, ambiguities and resulting revisions
COMP-004P1Publish the Shared Competencies guide1.2BlockedFirasCOMP-003 and applicable corrections; canonical definitions, examples, evidence limits and cross-links; independent of the review-method trial
REV-001P1Draft a Shared Competency Development Review1.2BlockedFirasCOMP-002; reflection/feedback worksheet, behavior anchors, insufficient-evidence handling and development actions; can overlap COMP-003
REV-002P1Trial and revise the development review1.2BlockedFirasCOMP-003, REV-001 and resolved expectations used by the review; compare independent judgments on shared examples and test usefulness
REV-003P1Publish the provisional development-review method1.2BlockedFirasREV-002; worked examples, applicability limits, editable artifacts and links to the canonical competency guide
V12-001P1Draft Work, Skills, and Team Adaptation guidance1.2ReadyFirasExisting work and research can seed the draft; incorporate pilot lessons when available
V12-002P1Try adaptation guidance in a real team review1.2BlockedFirasV12-001 and applicable corrections; a non-author reaches a responsibility or learning decision with an owner and check-back point

Keep at most three P0/P1 items In progress. Close release work, then use capacity for corrections, the workflow baseline/pilot, and shared-competency design. The adaptation draft is ready but is selected within the same capacity limit. Record estimated effort and maintenance cost before committing an item to a release; move an item to In progress only with a specific review date.

Completed implementation records RM-001, VER-001, FND-001, FND-002, FND-003 and FND-005 are retained with evidence in the history, docs/quality-baseline.md, docs/releases/1.0.1.md, and docs/updates.md. Their publication state is shown separately above.

Guidance Corrections and Dependencies

The Correction Register owns the replacement targets and acceptance checks. Source labels are in Evidence and Sources. Replacement guidance is still open.

  1. Expectations used to judge people: prioritize maturity/autonomy and least-member claims (C-02/C-03), staffing assumptions (C-04), decision ownership (C-05), and KPI interpretation (C-09).
  2. The workflow pilot’s operating boundaries: resolve applicability, accountable ownership and enforceable safeguards used by that pilot (C-01/C-05/C-06).
  3. Credibility repairs: qualify unsupported categorical claims, statistics, quotations and causal explanations (C-07/C-08) as independently reviewable changes.

Drafting and research can proceed while corrections are prepared. A published artifact or evaluative trial must resolve the expectations it actually uses. Document that dependency explicitly; the entire correction register or a replacement maturity instrument is not a prerequisite for every artifact. Urgent safety or credibility issues take priority within these groups.

Work Redesign Kit and Pilot

Question: Can a team use HELM to improve one real workflow and explain the consequences for delivery and people?

Publication gate: A non-author can use the kit without hidden instructions; ownership and safe stopping are clear; one approved example covers delivery and people impacts, failures and unknowns. A justified decision to keep the current approach counts. The shared-competency trial is independent of this gate.

Shared Competencies and Development

Question: Can people across roles understand shared working expectations, recognize supporting evidence, and use feedback to develop?

Competency foundation

Guide publication gate: Definitions are reconciled with existing HELM vocabulary, cross-role feedback has informed revisions, and examples and evidence limits are explicit. The guide can publish after its own checks; the later development-review trial does not block it.

First review method

The first output is a Shared Competency Development Review: what someone demonstrates, what evidence supports that view, and what they should practice next. It assesses shared behaviors; team operating maturity and role-specific delivery results are separate context.

Publication gate: Cross-role comprehension and the review trial are documented; examples demonstrate how evidence supports an assessment; missing evidence is distinguishable from weak performance; disagreements have informed revisions; a non-author can reach an actionable development plan. Publish with a provisional evidence label. These trials do not establish suitability for formal performance ratings, compensation or promotion decisions; that applicability remains separately evidence-gated.

Work, Skills, and Team Adaptation

Question: Does a team need to change its responsibilities, learning arrangements or handoffs as capabilities change?

Publication gate: A non-author reaches a clear next action without undocumented help; the example states responsibilities, learning needs and observation limits. A local field-tested guide can ship with those limits. Its publication does not wait for a competency-review product or a specific Phoenix report if another suitable real-work example supplies the evidence.

Later and Conditional Work

The retained backlog preserves unfinished supporting artifacts, the Specification Chain, optional diagnostic/scoring work, broader validation, function packs, company scope, operations and regional readiness.

Release and Maintenance Rules

Keep task state, validation evidence and publication state distinct. Task states remain Backlog, Ready, In progress, Blocked, In review, Done and Deferred. Done requires the named artifact/decision, appropriate checks and validation evidence, synchronized references, and a recorded completion link; it does not by itself mean deployed.

For each release, select applicable gates: compatibility decisions, relevant non-author trials, evidence labels, accessibility/content/security/build checks, coherent updates, and a correction/rollback path. Use docs/deployment.md, docs/updates.md and CONTRIBUTING.md for the existing operational procedures. The backlog holds remaining maintenance requirements, not a mandatory process for every adopting team.

Watch four immediate risks: inherited rules distort reviews (V11-002); evidence creates false precision (COMP-003/REV-002); workload blocks trials (name participants and respect capacity); and automation erodes learning opportunities (V12-001/V12-002). The complete risk register remains in the backlog. Reassess rather than silently carry old statuses forward.

Decisions and Update Log

2026-09-17 — Refresh priorities and actual dependencies

Maintaining this roadmap

Update the date and current focus, record real tracker states and evidence, assign review dates to active work, and add a dated decision when scope or dependencies change. Keep unfinished work in the active tracker or retained backlog, preserve stable IDs, and add a linked note to src/data/updates.json before regenerating the changelog. Archive superseded history rather than allowing it to override the current release map.