docs: Add Algorithm, Shadow Logic, and Discovery Tiers sections to README#1
Merged
Conversation
…ADME Agent-Logs-Url: https://github.com/sinhaankur/Archetype/sessions/defbd0e2-6f9d-401e-a02d-d80569e502f3 Co-authored-by: sinhaankur <14087196+sinhaankur@users.noreply.github.com>
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
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>
…ghlights # Conflicts: # README.md
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
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:
Original prompt