Repository navigation
Index lookup in python-dev-tca, and the README's business stakes - #5
Merged
Merged
Conversation
You are modeling a domain, not building a program. Reread the python-dev-tca skill, climb the layers bottom up from Scalar to Crossing, name each layer's nouns, model one file at a time, and after each file ask against the skill which noun is missing or misplaced, until no layer has one; with a flowchart of the loop.
TC001-TC003 demand `if TYPE_CHECKING:` blocks, and TCA forbids `if`. On Python 3.14 annotations are evaluated lazily, so the rules buy nothing.
The shop recommends related products after payment through a Qdrant grouped recommend query, modeled and run against a live Qdrant. - The action carries every rule the lookup must follow as scalars: closeness, one per aisle, the order's market and the limit. - One interpreter sends them as the index's query and reads its reply once; the hits cross into the domain as members of a collection. - The reply's shape picks the outcome: Recommended, NothingRelated or Unavailable. - The collection page names how a collection crosses a layer, and SKILL.md gains the rule that an action carries its effect's rules.
The fill example now reads on two levels at once: each bug carries its consequence for the desk, the unions show their docstrings, the table says what can no longer happen, the "you are about to" table names the question each construct settles, and each failure mode has an example.
kylejtobin
force-pushed
the
docs/index-lookup-and-readme
branch
from
October 7, 2026 21:09
d3ec89b to
13d6379
Compare
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
1 participant
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.
What
Recommended,NothingRelatedorUnavailable. The collection page names how a collection crosses a layer;SKILL.mdgains the rule and the diagram.TC001-TC003are ignored: they requireif TYPE_CHECKING:, which TCA forbids.Checked
ruff format; the diagram renders and every arrow names a box.just checkgates: ruff, basedpyright, smell-check and pytest pass.