Commit Graph

206 Commits

Author SHA1 Message Date
muratcankoylan aed122474c fix(ci): bind lifecycle checks to the protected base 2026-08-15 14:38:06 -04:00
muratcankoylan 45d72db20a feat(governance): enforce specification lifecycle and authority 2026-08-15 14:28:15 -04:00
muratcankoylan b2576ba4ae feat: publish machine-checked specification program 2026-08-11 09:51:38 -04:00
Muratcan Koylan 6dbe1a1d86 Merge pull request #120 from muratcankoylan/codex/spec-003-schema-registry
SPEC-003: add runtime-neutral schemas and immutable artifact identity
2026-08-10 10:37:37 -04:00
muratcankoylan dd9400aff2 feat(platform): add canonical artifact contracts 2026-08-10 10:36:43 -04:00
Muratcan Koylan 69bc429f6b Merge pull request #119 from muratcankoylan/codex/spec-002-public-private-boundary
SPEC-002: enforce the public/private artifact boundary
2026-08-10 10:36:40 -04:00
muratcankoylan 61bb052268 feat(governance): enforce public export boundary 2026-08-10 10:36:04 -04:00
Muratcan Koylan 4deb96cf1f Merge pull request #117 from muratcankoylan/codex/spec-001-repository-reconciliation
SPEC-001: reconcile the repository into a deterministic corpus
2026-08-10 10:36:01 -04:00
muratcankoylan e0d581ed61 feat(researcher): add deterministic corpus inventory 2026-08-10 10:34:20 -04:00
Muratcan Koylan 48bc565ab1 Merge pull request #116 from muratcankoylan/codex/spec-000-program-constitution
SPEC-000: establish the machine-testable program constitution
2026-08-10 10:34:17 -04:00
muratcankoylan 088958492c feat(governance): implement program constitution 2026-08-10 03:26:01 -04:00
Muratcan Koylan a1841d1ea3 Merge pull request #115 from kasparovabi/chore/opus5-compat
Update retired Sonnet 4 model id in pipeline template
2026-08-02 15:32:16 -04:00
kasparovabi 0416003aa2 Update retired Sonnet 4 id in pipeline template 2026-08-02 10:33:48 +03:00
Muratcan Koylan c578e85e40 Merge pull request #103 from muratcankoylan/cursor/long-horizon-prompting-showcase-4f9c
Release Long-Horizon Prompting with guide, prompt lab, references, and Pages site
2026-07-14 01:15:51 -04:00
Cursor Agent 5ca0ca10c6 Host Long-Horizon Prompting site from this monorepo Pages
Drop the dedicated-repo publish path. Restore GitHub Actions Pages
deploy on Agent-Skills-for-Context-Engineering while keeping the
on-page Long-Horizon Prompting brand.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-14 05:08:16 +00:00
Cursor Agent b63ec26904 Point site X links to @muratcan
Replace the old @koylanai handle with the current account.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-14 05:02:05 +00:00
Cursor Agent c2cc87a744 Name the site Long-Horizon Prompting, not the monorepo
Rebrand the project site identity and public Pages path to
long-horizon-prompting. Publish via a dedicated Pages repo so the
URL matches the project instead of Agent-Skills-for-Context-Engineering.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-14 05:01:34 +00:00
Cursor Agent 42ea3e547a Add Muratcan Koylan attribution with website and X links
Surface author credit on the overview byline and shared page footers,
linking to muratcankoylan.com and x.com/koylanai.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-14 04:55:44 +00:00
Muratcan Koylan 15e06fa256 Merge pull request #102 from muratcankoylan/cursor/long-horizon-prompting-showcase-4f9c
Release Long-Horizon Prompting with guide, prompt lab, references, and Pages site
2026-07-14 00:53:06 -04:00
Cursor Agent 199782ea48 Harden and deploy the long-horizon prompting site
Add deterministic HTML/metadata/link/reference/sitemap validation, exact rubric drift checks against the authoritative skill template, generated-file drift checks including untracked artifacts, and Puppeteer production tests under the real GitHub Pages base path. Test five pages across four viewport widths, clipboard controls, keyboard tabs, full prompt visibility, downloads, and no-JS fallbacks. Pin Pages workflow actions, split read-only build from privileged deployment, pin the skill install to a full commit, and commit the npm lockfile.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-13 13:50:07 +00:00
Cursor Agent 81b4e75acf Expand the prompt lab into an educational long-horizon prompting site
Reframe the project around the skill rather than the CDC case: add static Overview, Guide, Prompt Lab, References, and 404 pages; a copyable rubric-complete brief template; prompt/harness boundaries; gotchas and workflow; 33 caveated research/vendor references; eight generated prompt downloads; shared navigation and copy controls; accessible tab semantics; responsive editorial styling; and updated release screenshots. The CDC run is now explicitly one unreviewed case study, not the site's foundation.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-13 13:49:56 +00:00
Cursor Agent d5e9af744d Publish prompt lab as a complete GitHub Pages website
Turn the static comparison into a release site: full-height prompts on the website, capture-only bounded panes for PNGs, copy controls for every prompt and the Cursor install command, direct GitHub skill/repository/provenance links, a concise technical release explanation, responsive layout, social metadata, and an Actions-based Pages deployment. GitHub Pages still needs the one-time repository setting switched to GitHub Actions after merge.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-13 13:06:38 +00:00
Cursor Agent 3fd7014b0a Reflow prompt panes so screenshots fill column width
Collapse soft-wrapped source newlines into flowing paragraphs for display, keep section headers and lists intact, widen the lab layout, and recapture under shot-* paths so stale prematurely wrapped previews cannot linger.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-13 12:57:24 +00:00
Cursor Agent e5c09c8f8e Replace template-like briefs with complete optimized prompts
Rewrite all four right-side artifacts as copy-ready launch prompts generated with the long-horizon-prompting method. Remove every placeholder and add concrete success predicates, named non-solutions, evidence contracts, domain-specific audits, return gates, and harness boundaries. Fresh reviewers closed evaluation-leakage, production-signature, theorem-model, and security-scope defects. The UI now presents readable fixed-height prompt panes with word counts and Copy actions. Rename screenshots to optimized-* paths to prevent stale prompt previews.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-11 23:51:43 +00:00
Cursor Agent 2c1cda8593 Version editorial screenshots to bypass stale image caches
Move every redesigned PNG to a new editorial-* path, remove the superseded screenshot paths, update the README preview, and make the capture script emit only the cache-safe names. This prevents GitHub and Cursor from serving the old navy dashboard by URL.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-11 23:30:28 +00:00
Cursor Agent 46cd87d498 Redesign prompt lab as a minimal editorial research artifact
Replace the dark gradient dashboard, neon score cards, pill labels, and rounded panels with a restrained warm-paper system: serif display typography, black rules, generous whitespace, one muted accent, document-like prompt columns, and a methods-table scorecard. Simplify labels and recapture all 13 PNGs. The new assets are also about 1.2 MB smaller.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-11 23:26:07 +00:00
Cursor Agent fa98c1deb6 Document the long-horizon prompt lab and link it from the root README
Lab README covers the four use cases, the reproduce steps (fetch -> verify ->
install -> build -> capture), how to read the scorecard, and an explicit
honesty/limits section (skill's own rubric, per-pair residual risk, unreviewed
CDC proof). Add the example to the root README examples table.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-11 23:05:09 +00:00
Cursor Agent 894e7ec266 Add release screenshots: hero, before/after split, and rubric scorecard per use case
Generated by scripts/capture.mjs. Money-shot crops (hero, *-split, *-scorecard)
rendered at 2x for legible prompt text; *-full overview pages at 1x to keep the
committed set light (~6MB total).

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-11 23:05:03 +00:00
Cursor Agent b18b6087be Add prompt-pair data model and static before/after comparison UI
build_lab.py is the single source of truth: it defines the skill's 10-dimension
pre-launch rubric and four before/after prompt pairs (ML model-improvement run,
parallel approximation-ratio proof, distributed-systems RCA, security audit),
scores both versions, and emits data/prompt-pairs.json and ui/data.js.

The 'before' prompts are competent prompt-engineered launch prompts (persona,
context, chain-of-thought, explicit format, persistence); the 'after' briefs are
the skill's pseudo-formal task brief applied to each. Each pair records a residual
risk the brief cannot remove, and the UI carries an explicit honesty note that the
rubric is the skill's own. Aggregate rubric score moves 11% -> 100% across the four.

The UI is dependency-free and file:// safe (loads window.PROMPT_LAB_DATA from
data.js); capture.mjs drives system Chrome via puppeteer-core to render it.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-11 23:04:53 +00:00
Cursor Agent 3b127e8e2c Add reproducible installer for long-horizon-prompting into .cursor/skills
.cursor/ is gitignored (project-local IDE state), so install_skill.sh is the
committed record of the Cursor install: it copies the skill directory into
.cursor/skills/ and validates the installed copy with the reference agentskills
CLI. Verified locally with skills-ref 0.1.1 (Valid skill).

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-11 23:04:44 +00:00
Cursor Agent 23c0fa3a28 Bring CDC exemplar report local with provenance and faithfulness check
Fetch OpenAI's published GPT-5.6 Sol Ultra Cycle Double Cover prompt and
candidate proof (the exemplar the long-horizon-prompting skill is anchored on)
into examples/long-horizon-prompt-lab/report/, with SHA-256, source URLs, and
caveats recorded in PROVENANCE.md.

verify_report.py re-extracts the prompt and asserts every block-quote in the
skill's annotated CDC reference appears verbatim in the published source (0 drift
at retrieval), so the skill cannot silently diverge from the primary artifact.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-11 23:04:38 +00:00
Muratcan Koylan 47902b0bbf Replace link with DeepWiki badge in README
Updated the README to replace a link with a badge.
2026-07-11 18:14:49 -04:00
Muratcan Koylan f9225c691e Merge pull request #101 from muratcankoylan/cursor/long-horizon-prompting-skill-60a3
Add long-horizon-prompting skill (v2.5.0): pseudo-formal task briefs for long-running and parallel agents
2026-07-11 17:34:03 -04:00
Cursor Agent 521012828f Wire long-horizon-prompting into corpus, manifests, and docs for v2.5.0
3 mechanisms, 8 claims, 2 activation cases, 3 router prompts (p054-p056),
corpus index entry, accepted-ledger entries pending human PR review;
manifests bumped to 2.5.0; README, root SKILL.md, CLAUDE.md, AGENTS.md,
CHANGELOG updated for 17 skills. All deterministic gates pass.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-11 17:11:27 +00:00
Cursor Agent 6e6a07bd15 Add long-horizon-prompting skill with CDC prompt, vendor, and research references
Pseudo-formal task briefs for long-running autonomous agents and parallel
orchestrations: definitions with degenerate cases, exact success predicates,
non-counting outcomes, approach-registry diversity policy, adversarial audit
gates, effort floors, and contamination guards. Anchored on the published
GPT-5.6 Sol Ultra Cycle Double Cover prompt, cross-checked against OpenAI and
Anthropic doctrine and 2025-2026 research.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-11 17:11:27 +00:00
Muratcan Koylan c2b9a19107 Update contact link 2026-07-09 00:09:49 -04:00
Muratcan Koylan 1acd6681ce Merge pull request #98 from muratcankoylan/cursor/self-improvement-loops-skill-0cb9
Add self-improvement-loops skill: RSI, meta-harnesses, and evolutionary scaffold search (v2.4.0)
2026-07-08 01:04:30 -04:00
Cursor Agent 80d2d05a17 Bump to 2.4.0 for 16 skills across manifests and docs
Marketplace and Open Plugins manifests, README skill tables and counts,
root SKILL.md skill map and references, CLAUDE.md, AGENTS.md, and
CHANGELOG entry for the self-improvement-loops release.

Gates: frontmatter unit tests OK; validate_platform_compat 16 skills /
4 layouts; validate_repo --strict 0 errors; skill_health --strict
corpus 0.9172, 0 flagged (new skill 1.000); run_benchmarks 3 checks
0 failures; check_activation_cases 21/21.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-08 04:02:58 +00:00
Cursor Agent 11513d2198 Wire self-improvement-loops into researcher corpus
- 3 mechanisms: two-split-no-regression-acceptance,
  filesystem-experience-archive, runtime-enforced-loop-constraints
  (promoted via research_loop.py from run 20260708-034419 after
  novelty pass at 0.1246 vs 0.18 threshold and run readiness)
- 6 primary-source claims with provenance
- 2 activation cases for the harness-engineering boundary (21/21 pass)
- Router prompts p051-p053; p036 gains self-improvement-loops as
  acceptable secondary
- Corpus index entry mapping scenarios, mechanisms, claims

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-08 04:02:58 +00:00
Cursor Agent e7c2047c74 Add self-improvement-loops skill (RSI, meta-harnesses, evolutionary scaffold search)
Sixteenth skill covering systems where the harness itself is the
optimization target: failure-driven bounded self-edits, meta-harness
search, evolutionary scaffold search, context mechanism evolution, and
acceptance gates for self-modifying systems. Anchored on Weng's
'Harness Engineering for Self-Improvement' (Lil'Log, 2026-07-04) with
all load-bearing mechanisms cross-verified against primary sources
(Self-Harness, Meta-Harness, MCE, ACE, DGM, AlphaEvolve, ShinkaEvolve,
STOP, ADAS, AFlow, METR, Anthropic). Volatile numbers live in a dated
reference file per the claim-provenance policy.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-07-08 04:02:58 +00:00
Muratcan Koylan 175cee7c25 Merge pull request #97 from muratcankoylan/cursor/polish-production-readiness-e126 2026-06-29 17:52:52 -04:00
Cursor Agent 8fc51c7cba chore: polish repo-wide production readiness
Normalize every SKILL.md description to double-quoted YAML so the corpus,
templates, and examples have one visible convention. Harden frontmatter
parsing against partial fence matches and non-string name/description values,
and extend tests to cover those regressions.

Fix stale or misleading developer-facing docs: remove phantom book-sft plugin
install instructions, document directory-copy installs, add .agents/skills
manual install guidance, fix the digital-brain setup script target, and mark
historical 13-skill analysis as historical. Cut the prepared release metadata
to 2.3.1 across manifests and root SKILL.md.

Tighten production gates by sharing dev dependencies, making orchestrators use
strict repo validation, aligning skill-health required sections with repo
validation, and linting documented plugin install commands against the actual
marketplace manifest.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-06-29 21:50:47 +00:00
Muratcan Koylan 9749e5cbda fix: certify production Agent Skills compatibility across Cursor, Claude Code, and Codex (#96)
* fix: YAML-safe skill frontmatter for cross-platform discovery

Eleven skills used unquoted descriptions containing colons, which strict
YAML parsers reject during skill discovery on Cursor, Claude Code, and
Codex. Normalize all skill frontmatter to valid YAML, add a shared
skill_frontmatter parser with PyYAML validation, fix install docs to use
directory layout, and add .agents/skills symlink plus Open Plugins
skills path declaration.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>

* test: add frontmatter parser unit tests and harden examples

Add researcher/scripts/tests/test_skill_frontmatter.py (19 tests) covering
parser edge cases, a strict-YAML regression guard for the unquoted-colon
bug, format/parse round-trips, and corpus + example integration checks.
Wire unit tests into CI ahead of the strict repo gate. Quote the
description fields in the two example skills that had the same
unquoted-colon YAML hazard. Simplify CRLF handling in split_frontmatter
and document CONTRIBUTING test commands.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>

* chore: harden production plugin packaging validation

Remove the committed .agents/skills symlink because symlinks are fragile
on Windows checkouts and in plugin packaging. Keep Cursor and Codex
support through Open Plugins discovery and documented directory-copy
manual installs.

Extend validate_repo.py so strict validation checks that the Open
Plugins manifest and Claude marketplace manifest name the same bundled
plugin, and that Open Plugins skills discovery resolves to the same 15
published skills as the repository.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>

* ci: certify cross-platform skill compatibility

Add validate_platform_compat.py to check the production surfaces defined by
Agent Skills, Cursor, Claude Code, Codex, and Open Plugins documentation.
The gate validates published skills, manifest discovery parity, and
platform-local directory-copy installs for .cursor/skills, .claude/skills,
.codex/skills, and .agents/skills.

Install skills-ref in CI and require the upstream agentskills reference
validator in the compatibility gate. Tighten manifest path checks so both
Claude marketplace and Open Plugins skill paths must start with './', and
update operator docs to run the new gate before claiming production
readiness.

Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Muratcan Koylan <muratcankoylan@users.noreply.github.com>
2026-06-29 16:52:07 -04:00
Muratcan Koylan 25e1fa79a3 Update README.md 2026-05-26 01:36:55 -04:00
Muratcan Koylan 61f38ffc0f Merge pull request #87 from muratcankoylan/agents/autonomous-org-harness
Release v2.3.0: measured router benchmark + corpus-wide skill hardening
v2.3.0
2026-05-22 00:19:40 -04:00
muratcankoylan d51ac9bea8 Vendor v2.3.0 release SVGs into the repo
Embed the four release diagrams (researcher OS pipeline, router leaderboard, skill routing gains, corpus hardening metrics) so the v2.3.0 release notes can link to stable raw GitHub URLs instead of the regenerating draft asset slug.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-19 02:23:20 -04:00
muratcankoylan cbc2c97813 Harden full skill corpus for v2.3.0 release
Apply the auto-research quality standard across every published skill and update the mechanisms, claims, fixtures, benchmarks, and release docs so the corpus improves as a coherent system rather than isolated prose edits.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-19 02:08:06 -04:00
Muratcan Koylan b9a4c9dafe Format citations as a numbered list in README.md
Updated citation formatting in README.md to use numbered list.
2026-05-19 01:51:19 -04:00
Muratcan Koylan 9fc909d88c Update README.md 2026-05-19 01:50:50 -04:00
Muratcan Koylan 4a5ca3f669 Update citations in README.md
Updated citation year for the first reference and added a new reference.
2026-05-19 01:50:34 -04:00