docs(readme): document the extension model - portals, templates, criteria, borrowing from forks

Prompted by the extension-system question in discussion #249: the three
extension points existed as folklore across #78, /add-portal, and closed
PRs. Now stated plainly, with a read-the-code-first checklist for
borrowing portal skills and the rationale for why there is no installer.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Mads Lorentzen
2026-07-30 11:04:45 +02:00
co-authored by Claude Fable 5
parent 5a9f6c42a4
commit 7a753f3cd4
2 changed files with 27 additions and 0 deletions
+9
View File
@@ -13,6 +13,15 @@ per-file diff commands.
## [Unreleased]
- **README: the extension model, documented** - new Customization subsection "Extending the
framework: portals, templates, criteria - and borrowing from other forks". States plainly
what was previously folklore: the three extension points (portal skills with their
auto-discovered contract, `/add-template` toolchains, free-form evaluation criteria), the
copy-one-folder pattern for borrowing a portal skill from another fork with a
read-the-code-first checklist, and why there is deliberately no installer (the manual copy
is the security model). Documentation only - no behavior changes. Prompted by the
extension-system question in discussion #249.
- **freehire-search: full descriptions come back with the search** - `search` now calls
freehire's agent search endpoint (`/api/v1/agent/jobs/search`), which serves each hit's
complete description instead of the search index's truncated preview. A 20-role search is