Skip to content

docs: Add Algorithm, Shadow Logic, and Discovery Tiers sections to README#1

Merged
sinhaankur merged 4 commits into
mainfrom
copilot/add-readme-highlights
Apr 29, 2026
Merged

docs: Add Algorithm, Shadow Logic, and Discovery Tiers sections to README#1
sinhaankur merged 4 commits into
mainfrom
copilot/add-readme-highlights

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 23, 2026

The README lacked any technical depth — no explanation of the scoring model, edge-case detection, or how the assessment progresses to a result.

Changes

  • The Algorithm — Documents the Weighted Trait Matrix: archetypes as 5-dimensional trait vectors (Dominance, Empathy, Independence, Creativity, Discipline), with user results computed via weighted dot-product similarity:

    similarity(user, archetype) = Σ (weight_i × user_trait_i × archetype_trait_i)
    
  • Shadow Logic — Describes unbalanced-profile detection. Example: high Independence + Empathy < 20% surfaces a ⚠️ Rebel Shadow warning. Covers that triggers are evaluated across all trait pairings.

  • Discovery Tiers — Outlines the three-stage narrowing process:

    • Core Driver — Motivational quadrant placement (Power, Connection, Expression, Structure)
    • Action Style — Execution strategy layer; narrows candidates within the quadrant
    • Refinement — Decision-tree questions for final archetype lock + Shadow warning resolution
Original prompt

Suggested README.md Highlights

If you are setting up the repository now, including these sections will make it stand out:

The Algorithm: Briefly explain the "Weighted Trait Matrix." (e.g., “Each archetype is a vector in a 5-dimensional trait space; user results are calculated via dot-product similarity.”)

Shadow Logic: Mention how the engine detects "unbalanced" profiles (e.g., high Independence but <20% Empathy triggers the "Rebel Shadow" warning).

Discovery Tiers: 1.  Core Driver: Quadrant identification.
2.  Action Style: Execution strategy.
3.  Refinement: Final archetype lock.

Copilot AI changed the title [WIP] Add README.md highlights for algorithm and discovery tiers docs: Add Algorithm, Shadow Logic, and Discovery Tiers sections to README Apr 23, 2026
Copilot AI requested a review from sinhaankur April 23, 2026 13:11
Replaces the Copilot-drafted README sections with descriptions that
actually match the code:

- Algorithm: corrects the trait names to Independence, Empathy, Wisdom,
  Skills, Creativity (the actual five used in scoring) and notes that
  every archetype weight row sums to 1.0.
- Drops the "Shadow Logic" section, which described a feature not
  present in the codebase.
- Discovery Tiers: rewrites the three modes to reflect Standard / Deep /
  Deep Dive (10 / 20 / 30 questions, 2 / 4 / 6 per trait) drawn from a
  90-question pool with seeded per-session sampling, instead of the
  fictional "quadrant narrowing" flow.
- Restores the GitHub Pages Test Site instructions that the PR base had
  dropped.

Built by sinhaankur.com

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@sinhaankur sinhaankur marked this pull request as ready for review April 29, 2026 02:04
@sinhaankur sinhaankur merged commit ba4e4bb into main Apr 29, 2026
@sinhaankur sinhaankur deleted the copilot/add-readme-highlights branch April 29, 2026 02:05
sinhaankur added a commit that referenced this pull request May 15, 2026
…ADME (#1)

* Initial plan

* docs: add Algorithm, Shadow Logic, and Discovery Tiers sections to README

Agent-Logs-Url: https://github.com/sinhaankur/Archetype/sessions/defbd0e2-6f9d-401e-a02d-d80569e502f3

Co-authored-by: sinhaankur <14087196+sinhaankur@users.noreply.github.com>

* Rewrite README sections to match implementation

Replaces the Copilot-drafted README sections with descriptions that
actually match the code:

- Algorithm: corrects the trait names to Independence, Empathy, Wisdom,
  Skills, Creativity (the actual five used in scoring) and notes that
  every archetype weight row sums to 1.0.
- Drops the "Shadow Logic" section, which described a feature not
  present in the codebase.
- Discovery Tiers: rewrites the three modes to reflect Standard / Deep /
  Deep Dive (10 / 20 / 30 questions, 2 / 4 / 6 per trait) drawn from a
  90-question pool with seeded per-session sampling, instead of the
  fictional "quadrant narrowing" flow.
- Restores the GitHub Pages Test Site instructions that the PR base had
  dropped.

Built by sinhaankur.com


---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: sinhaankur <14087196+sinhaankur@users.noreply.github.com>
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.

2 participants