René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Agent config to explain the principle of using docstring for reference material","articleBody":"@copilot+claude-sonnet-4.6 wrong way of generating functions.txt. should use a hook similar to how we generate module-tree.txt\n\n_Originally posted by @nathanjmcdougall in https://github.com/usethis-python/usethis-python/issues/1624#issuecomment-4149037996_\n\nRather than summarizing code objects e.g. functions, classes, and modules with a manually maintained reference material, it is always better to have a \"one source of truth\" mindset and use the docstring via automation hooks/packages to extract the relevant information and keep it in-sync. For example, the docs/module-tree.txt design.\n\nThis information should go into a new skill called `usethis-agents` which provides a directory for all the `usethis-skill-*` skills (again, maintained via a prek hook according to this very principle!), as well as instructions for maintaining `AGENTS.md`.\n\n            ","author":{"url":"https://github.com/nathanjmcdougall","@type":"Person","name":"nathanjmcdougall"},"datePublished":"2026-03-28T23:46:38.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/1625/usethis-python/issues/1625"}