Documentation

Check reference

Helen's Foundry continuously checks your workspace and shows its findings in Reconcile. There are 25 kinds of findings. None of them is an error. Each one below says what it means and what to do about it.

Structural

Building on a discontinued foundation

stale-premise

Active work builds on an artifact above it that was abandoned, marked obsolete, or marked a duplicate

Active work builds on an artifact above it that was abandoned, marked obsolete, or replaced.

Close this artifact if that closure makes it unnecessary, or move it under an active parent.

Draft with no recent activity

stale_draft

This draft has had no edits during the stale-draft window

This draft needs ratification to take effect, but nobody has edited it recently.

Propose it for ratification if you still want it, or archive it.

Duplicate singleton

duplicate-singleton

More than one open, unarchived artifact of a single-instance type exists

More than one open, unarchived artifact has a type that allows only one in this workspace.

Keep the current artifact and close or archive the duplicates.

In progress with no priority set

priority-vacuum

Work in progress or in review has no priority set

This artifact is in progress or in review, but it has no priority. You cannot rank it against other in-flight work.

Set a priority so you can rank it against other in-flight work.

In progress, but unassigned

unowned-in-flight

Work in progress or in review has no owner assigned

This artifact is in progress or in review, but it has no owner.

Assign the person working on it so ownership is clear.

Lifecycle data inconsistency

lifecycle-contradiction

Lifecycle fields on this artifact disagree with each other

Lifecycle fields on this artifact disagree with each other. For example, an open artifact has a closure reason.

Update the lifecycle state or closure reason so the fields match.

No owner

missing-accountable-owner

A goal or strategy has no owner

This goal or strategy has no owner. Nobody is accountable for its outcome.

Assign an owner who is responsible for this artifact.

No shared top-level goal

no-prime-goal

Multiple top-level goals or strategies have no shared parent

Several top-level goals or strategies have no shared parent, so they may point in competing directions.

Create a shared parent, or decide which one comes first.

No work addresses this yet

coverage-gap

No project serves this persona or addresses this problem definition

No active project serves this persona or addresses this problem definition.

Link the closest project to it. If you are parking it on purpose, close it.

Not broken into tasks yet

decomposition-gap

A strategic artifact has no execution artifacts below it

This artifact has children, but none of them are execution artifacts.

Break it into projects or tickets when you are ready to start the work.

State disagrees with a closed parent

lifecycle_inconsistency

Open or draft work sits under a parent that completed or migrated

A parent of this artifact completed or migrated, but this artifact is still open or a draft. Another parent may still be active.

Close this artifact, move it to an active parent, or keep it open on purpose.

Stranded by a completed parent

stranded-by-closure

Open work sits under a parent that completed or migrated

This artifact's parent completed or migrated, but this artifact is still open.

Close this artifact, carry it forward under a new parent, or move it to an active parent.

Two people working on the same thing

coordination-collision

Two owners are working on overlapping artifacts under one parent

Two owners are working on overlapping artifacts under the same parent at the same time.

Check whether this overlap is intentional, or defer or merge one of the artifacts.

Urgent, no owner

resource-misallocation

Urgent work under a goal or strategy has no owner assigned

This goal or strategy has high-priority work below it, but no work under it has an owner.

Urgent work can stall when nobody owns it. Assign an owner to at least one artifact below it.

Recency

No one stands behind this

review-cadence-breach

Needs ratification, or validation is due for renewal

Nobody has ratified the current version, or its validation has expired.

Ratify a version that has no ratification. If it is already ratified, renew validation without changing who has authority.

Plan hasn't kept up with the work

plan-of-record-staleness

Work below this plan changed without an update to the plan

Work below this plan keeps changing, but the plan itself has not been updated.

Update the plan to match current work, or acknowledge the difference.

Stale project with no active work

zombie-project

An active project has only closed work and no recent updates

This project is still marked active, but all of its work is closed and nobody has updated it recently.

Close the project if the work is done, or add new work if it is still active.

Semantic

Contradicts a related artifact

semantic-contradiction

Two artifacts appear to state conflicting goals or directions

These two artifacts appear to state conflicting goals or directions.

Review both artifacts. If they conflict, decide which direction is right and update or close the other one.

Contradicts its parent

chain-contradiction

A child artifact appears to contradict the parent it serves

This child artifact appears to contradict the intent of its parent.

Review both artifacts. If they conflict, reframe, move, or close the child.

Copied from parent instead of decomposed

copy-paste-cascade

A child artifact appears to repeat its parent instead of breaking down the work

This child appears to repeat its parent instead of breaking the work into a specific step.

Review both artifacts. If the child repeats the parent, rewrite it as a specific part of the parent's work.

Possible duplicate intent

redundant-overlap

Two artifacts appear to state the same intent

These two artifacts appear to state the same intent in different places.

Review both artifacts. If they overlap, merge them into one artifact or clarify how they differ.

Vector

Sub-items don't fit together

horizontal-incoherence

An artifact's children pull in unrelated directions

This artifact's children pull in unrelated directions instead of supporting one shared purpose.

Check whether these children belong under this parent, or move them under different parents.

Property

Doesn't meet its quality rubric

artifact-quality

Artifact does not meet its quality rubric

This artifact does not meet its type, writing, or specification rubric.

Revise its text or specifications before the next update.

Metric no one is working toward

orphaned-metric

No artifact below this goal or strategy addresses its metric

This goal or strategy states a measurable target, but no work below it addresses that target.

Create work that addresses the metric, or remove the metric if it no longer applies.

Portfolio

Distribution observation

portfolio-distribution-anomaly

Child work under this parent is concentrated by priority or branch

Work is concentrated in one priority or branch, or has no priority set.

Check whether this distribution matches your priorities.