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-premiseActive 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_draftThis 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-singletonMore 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-vacuumWork 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-flightWork 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-contradictionLifecycle 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-ownerA 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-goalMultiple 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-gapNo 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-gapA 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_inconsistencyOpen 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-closureOpen 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-collisionTwo 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-misallocationUrgent 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-breachNeeds 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-stalenessWork 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-projectAn 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-contradictionTwo 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-contradictionA 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-cascadeA 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-overlapTwo 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-incoherenceAn 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-qualityArtifact 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-metricNo 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-anomalyChild 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.