Skip to content

Refresh virtues-revisited essay: survey + personality radar integration#195

Merged
klappy merged 1 commit into
mainfrom
essay/virtues-revisited-survey-personality-integration
May 11, 2026
Merged

Refresh virtues-revisited essay: survey + personality radar integration#195
klappy merged 1 commit into
mainfrom
essay/virtues-revisited-survey-personality-integration

Conversation

@klappy
Copy link
Copy Markdown
Owner

@klappy klappy commented May 10, 2026

Summary

Refreshes the Software Virtues, Revisited essay (writings/software-virtues-revisited.md) to incorporate canon that landed after the essay was first published — specifically the seven-phase Quality Attribute Tension Survey method, the dual-state (current + desired) framing, the DOLCHEO Constraints/Observations/Opens output types, the oddkit runtime contract, and the personality-test/radar-chart framing with the worked-example SVG.

The first draft closed with "what I'm building next." The system kept moving; the closing was stale.

What changed

  • Top blockquote updated to land the full arc — matrix → survey → personality-test reframe — in one paragraph.
  • What This Becomes NextWhat This Became. Replaces the four-bullet forward sketch with a compressed description of:
    • the seven-phase shape (Stage → Ility Selection → Phase-Weighted Ranking → Tension Surfacing → Sacrifice Acknowledgment → Output Encoding → Re-Run Triggers, named not respecified)
    • dual-state framing (current + desired in one pass)
    • DOLCHEO output: Constraints for desired state, Observations for current state, Opens for gaps as roadmap
    • oddkit runtime contract: preflight, gate, challenge, encode, validate wired to phase boundaries
  • New section: The Survey Is a Personality Test for the Product. The audience-facing reframe and the essay's new payoff. Includes:
    • the personality framing (radar with one axis per ility, polygon = project's shape)
    • tension-opposite axis ordering (the silhouette is the tradeoff record by construction)
    • MoSCoW scale rationale (categorical matches the level decisions are made at)
    • dual polygons (desired = solid; current = dashed) — the radar is the roadmap, visualized
    • the embedded worked-example SVG from canon (pilot-stage authentication service)
    • three things the picture makes visible: gap is roadmap, tension-opposite shows tradeoff structurally, honest profile is asymmetric
  • Where to Go Next gains an entry pointing at klappy://canon/methods/quality-attribute-tension-survey.
  • Frontmatter:
    • derives_from adds canon/methods/quality-attribute-tension-survey.md
    • tags add tension-survey, personality-radar
    • hook, description, og_description, twitter_description refreshed for social-graph parity with the new arc

What was preserved intact

Original load-bearing sections retained without edits:

  • A Question from a Partner
  • What the Article Got Right (the ten virtues list, the central no-single-objective-function claim)
  • What the Article Only Sketched (the 21-of-45 named pairs observation)
  • What the Matrix Looks Like (four relationship types, phase weighting, three uses)
  • Article Lacked an Operator
  • Honest Is Overwhelming
  • What I Stand By (the five-claim central thesis)

The voice is unchanged. The five-claim thesis is unchanged.

What was deliberately not done

Three Opens from odd/ledger/2026-05-10-software-virtues-canon-package remain pending operator review and are NOT addressed in this PR:

  • O-open P1 — observability-class virtues inclusion in the matrix
  • O-open P2 — strength of the ODD tie in "Article Lacked an Operator"
  • O-open P3 — MoSCoW / Hundred Dollar Method positioning at the operational level

Each is its own decision; bundling them here would have widened scope without resolving them.

Reversibility

Canon prose, single-file change. No code, no SDK lock-in, no schema migration. Revert is a follow-up PR; the original content lives in git history. Social-graph metadata changes (og/twitter descriptions) will refresh on next crawl.

Diff size

1 file changed, 144 insertions(+), 26 deletions(-)

Closes the stale forward-looking arc; opens the door for the standalone personality-test essay teased in the survey canon to land as a non-technical entry point downstream.


Note

Low Risk
Low risk: prose-only updates in a single markdown essay plus metadata tweaks; main risk is broken links/rendering of the embedded SVG in downstream publishing.

Overview
Updates writings/software-virtues-revisited.md to reflect the now-shipped Quality Attribute Tension Survey method, reframing the essay’s arc from “what I’ll build next” to “what this became”.

Adds a new personality-test framing with a dual-state (current vs desired) radar chart, including an embedded worked-example SVG, and refreshes frontmatter/social metadata (tags, derives_from, hook/description, OG/Twitter blurbs) plus a new “Where to Go Next” link to the survey.

Reviewed by Cursor Bugbot for commit 5a2c925. Bugbot is set up for automated code reviews on this repo. Configure here.

…ing, radar

The original closing arc described the constraints survey as 'what I am
building next.' That survey was built the same day, with depth the four-
bullet sketch could not anticipate: a seven-phase method, dual-state
(current + desired) framing, DOLCHEO Constraints/Observations/Opens as
typed outputs, and a runtime contract wiring oddkit_preflight, _gate,
_challenge, _encode, _validate to phase boundaries.

This revision:

- Replaces 'What This Becomes Next' with 'What This Became' — compresses
  the seven-phase shape into a paragraph, names the dual-state output,
  introduces the three DOLCHEO artifact types, names the runtime
  contract wiring without re-specifying the method.
- Adds 'The Survey Is a Personality Test for the Product' as the new
  payoff section. Embeds the canon worked-example radar SVG inline
  (pilot-stage authentication service, dual polygons, tension-opposite
  axis ordering, MoSCoW scale). Names the three things the picture
  makes visible: the gap is the roadmap, tension-opposite axes show
  the tradeoff structurally, an honest profile is asymmetric.
- Updates the top blockquote and hook to reflect the new arc.
- Adds canon/methods/quality-attribute-tension-survey.md to derives_from.
- Adds 'tension-survey' and 'personality-radar' tags.
- Adds Where to Go Next entry pointing at the survey method canon.
- Refreshes og_description and twitter_description for social-graph
  parity with the new framing.

Original load-bearing sections preserved intact: 2018 reflection, What
the Article Got Right, What the Article Only Sketched, What the Matrix
Looks Like, Article Lacked an Operator, Honest Is Overwhelming, What I
Stand By. The five-claim central thesis is unchanged.

Three ledger Opens (P1 observability inclusion, P2 ODD tie strength,
P3 MoSCoW position) deliberately not addressed — those remain pending
operator review per odd/ledger/2026-05-10-software-virtues-canon-package.
@github-actions
Copy link
Copy Markdown

Canon Quality — oddkit_audit

No dead klappy:// references or legacy link patterns found in writings/. 41 files scanned.

Spec: klappy://docs/oddkit/specs/oddkit-audit · Workflow: .github/workflows/canon-quality.yml · Run: #119

@klappy klappy merged commit 5afd696 into main May 11, 2026
2 checks passed
@klappy klappy deleted the essay/virtues-revisited-survey-personality-integration branch May 11, 2026 00:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant