Interface Facts
Establish how a third-party interface behaves from evidence you observe now. A model knows an interface only as it was at training time, and vendors change interfaces.
The skill covers CLI flags and output formats, API fields and endpoints, model ids, context windows, token accounting, prices, rate limits, config schemas and behaviour that changes with a version.
Steps
Do steps 1 to 4 in order and stop at the first one that answers the question. If an earlier step contradicts that answer, take the vendor's answer and say what disagreed. Always do step 5.
- Read our own code that touches the interface:
git grep -n TOOL; an empty result counts as absence only after the same search finds a known match. An adapter, a parser or a hook was written against a real probe and is under test. Read it before our own prose. - Run the installed binary:
TOOL --help,TOOL --version,--dry-run, or an invalid flag whose error names the valid set. For a default behaviour, run the command itself; a flag list does not show a default. - Fetch the vendor's current documentation from the route in routes. Limit any search to the vendor's own host; an aggregator, a mirror or a summary is not a source. Ask a narrow question: the exact flag or field name. Use browser tools only when a page needs JavaScript.
- Read the vendor's changelog when a version matters, and the vendor's source or issue tracker when a documented feature does not work.
- Record the fact, as shown below.
Writing by anyone other than the vendor is the weakest evidence and never enough alone. A landing page or a feature grid is marketing. A README is a claim.
State the claim precisely
- Keep "the capability exists" apart from "we can reach it". A documented feature can have no flag or output mode that our dispatch can read. A value that is not on stdout can still be readable from another place.
- Write the claim at the precision the evidence supports. "Has no config-file deny rule" is correct where "has no config file" is not. A vague note invites the next reader to remove what it justifies.
Record the fact
Comment on the tracker record, as work-tracker shows, with verified DATE against URL (TOOL VERSION): .... Never cache or commit the fetched page; its licence is not ours to give.
When a repo document and the vendor disagree, the vendor decides what the interface does. The repo decides what we chose to do. Correct the document in place and name what refuted it.
When a value we depend on can be compared with data we already record, make the comparison a gate. A declared limit that recorded data contradicts is a defect that a machine can detect.