Skip to content

chore: compact skills and readmes #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
legrab merged 1 commit into from
Aug 8, 2026
Merged

chore: compact skills and readmes #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 23 additions & 20 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,46 +2,49 @@

## Purpose

Maintain a small harness for safe agentic collaboration, deliberate codebase learning, and conversational learning about general topics. Preserve the separation between:
Maintain a small harness for safe agentic collaboration, repository learning, and conversational learning about general topics.

Preserve the separation between:

- repository-specific engineering rules;
- general collaboration behavior in `agentic-flow/`;
- optional repository learning in `learning-flow/`;
- generic conversation behavior in the common `learn-anything` skill;
- private learning and temporary task state under `.local/`.
- `agentic-flow/` collaboration behavior;
- `learning-flow/` repository learning;
- `learn-anything` general learning;
- private `.local/` continuity.

## Educational authority

Use `sample/common/agentic-flow/EDUCATION.md` as the shared educational constitution for both learning routes. Keep it selective, repository-agnostic, and focused on durable human ownership.
Use `sample/common/agentic-flow/EDUCATION.md` as the shared educational constitution.

Low-frequency task procedures belong in skills. Always-loaded instructions should contain routing, boundaries, and short invariants rather than duplicate teaching scripts.
Learning behavior should be automatic, not opt-in prose. Low-frequency procedures belong in skills. Always-loaded instructions should contain routing, boundaries, and short invariants rather than teaching scripts.

## Generic conversational learning
## Default learning behavior

When the user explicitly wants to learn a non-repository topic, treat this checkout as the host rather than the subject. Use `learn-anything`, do not inspect repository code, and let the direct question govern the session.
For every user request, apply the educational model at the smallest useful depth.

For meaningful continuity, follow `sample/common/agentic-flow/LOCAL.md`. Keep complete private session state under `.local/`, and promote only clearly reusable framework knowledge deliberately.
- `help me understand`, `explain`, `teach me`, and similar general questions → `learn-anything`;
- questions about this repository → repository learning;
- implementation work → normal delivery, with learning reinforcement when it materially improves ownership;
- one consequential or ambiguous change → `structured-change` alongside the active route.

If this source checkout has no `.local/` workspace yet, create `.local/{sessions,follow-ups}` and seed `.local/learning-history.md` from `sample/common/local/learning-history.md`. Never overwrite existing local state.
Keep the exchange conversational. Build a compact model, use one useful example or experiment when helpful, and use at most one check-back when it can reveal a mistaken model. Do not turn mechanical work into a lesson.

## Working rules

- Read `README.md`, `docs/DESIGN_NOTES.md`, and `CHANGELOG.md` before structural changes.
- Keep minimal, full, and general learning behavior aligned through the common educational constitution.
- Prefer a small common rule over duplicated profile-specific prose.
- Keep direct session goals primary. Human values, resilience, and domain lenses are selective.
- Prefer one common rule over duplicated profile-specific prose.
- Keep direct task goals primary.
- Do not add workflow ceremony without a demonstrated problem.
- Treat installer update and preservation behavior as part of the public contract.
- Update manifests, version markers, examples, and regression fixtures with framework changes.
- Treat installer update and preservation behavior as public contract.
- Keep the framework usable across languages, build systems, repository sizes, and industries.
- Never persist inferred distress, health, identity, secrets, customer data, or sensitive operational evidence.

## External reference integration
## External references

When asked to incorporate value from another repository, article source, or ZIP, follow `docs/references/REFERENCE_INTEGRATION.md`.
When incorporating another repository, article, or ZIP, follow `docs/references/REFERENCE_INTEGRATION.md`.

Extract the smallest generally useful patterns, preserve source-specific rules only in the reference review, and add `docs/references/REFERENCE_REVIEW_<SOURCE>.md` for provenance and historical context.
Extract only the smallest generally useful patterns and record provenance in `docs/references/REFERENCE_REVIEW_<SOURCE>.md`.

## Communication

Use direct, summary-first language. Say what changed and why it matters, grouping substantial updates into a few descriptive sections rather than a tool log or file inventory. Put secondary rationale, long examples, command matrices, and historical notes in `<details>` blocks when supported. Never hide required warnings, decisions, or next actions inside a collapsed section.
Use direct, summary-first language. Group substantial updates by outcome. Put secondary rationale, long examples, command matrices, and historical notes in `<details>` blocks. Keep warnings, decisions, validation failures, and required next actions visible.
20 changes: 10 additions & 10 deletions MANIFEST.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.gitattributes 40
.gitignore 324
AGENTS.md 3172
AGENTS.md 2524
CHANGELOG.md 17352
docs/AGENTIC_WORKFLOW_SANITY.md 7795
docs/ARCHITECTURE.md 6009
Expand All @@ -16,24 +16,24 @@ docs/references/REFERENCE_REVIEW_LEARNING_FLOW_ADJUSTMENT.md 9505
docs/references/REFERENCE_REVIEW_LITT.md 2069
docs/references/REFERENCE_REVIEW_POCOK.md 2155
LICENSE 2213
README.md 17154
sample/common/.agents/skills/agentic-workflow/SKILL.md 4185
README.md 8143
sample/common/.agents/skills/agentic-workflow/SKILL.md 2686
sample/common/.agents/skills/learn-anything/agents/openai.yaml 246
sample/common/.agents/skills/learn-anything/SKILL.md 3362
sample/common/.agents/skills/learn-anything/SKILL.md 1756
sample/common/.agents/skills/structured-change/knowledge/engineering/ai-collaboration.md 2533
sample/common/.agents/skills/structured-change/knowledge/engineering/architecture.md 1386
sample/common/.agents/skills/structured-change/knowledge/engineering/dependency-management.md 1300
sample/common/.agents/skills/structured-change/knowledge/engineering/documentation.md 1334
sample/common/.agents/skills/structured-change/knowledge/engineering/maintainability.md 1319
sample/common/.agents/skills/structured-change/knowledge/engineering/modernization.md 1254
sample/common/.agents/skills/structured-change/knowledge/engineering/testing.md 1287
sample/common/.agents/skills/structured-change/SKILL.md 4283
sample/common/.agents/skills/structured-change/SKILL.md 1946
sample/common/.agents/skills/structured-change/templates/design.md 649
sample/common/.agents/skills/structured-change/templates/exploration.md 368
sample/common/agentic-flow/.managed-files 170
sample/common/agentic-flow/.managed-skills 86
sample/common/agentic-flow/.template-version 6
sample/common/agentic-flow/AGENTS.md 8182
sample/common/agentic-flow/AGENTS.md 4121
sample/common/agentic-flow/CONFIGURE.md 4475
sample/common/agentic-flow/DECISIONS.md 963
sample/common/agentic-flow/EDUCATION.md 5232
Expand Down Expand Up @@ -68,7 +68,7 @@ sample/profiles/full/.agents/skills/challenge-debugging/templates/challenge.md 4
sample/profiles/full/.agents/skills/change-explainer/SKILL.md 1308
sample/profiles/full/.agents/skills/change-explainer/templates/change-explainer.md 290
sample/profiles/full/.agents/skills/learning-bootstrap/SKILL.md 1522
sample/profiles/full/.agents/skills/repository-orientation/SKILL.md 1382
sample/profiles/full/.agents/skills/repository-orientation/SKILL.md 1222
sample/profiles/full/.agents/skills/safe-refactor/SKILL.md 1373
sample/profiles/full/.agents/skills/ticket-learning-path/SKILL.md 1519
sample/profiles/full/.agents/skills/ticket-learning-path/templates/ticket-learning-path.md 348
Expand All @@ -89,13 +89,13 @@ sample/profiles/minimal/learning-flow/.managed-files 87
sample/profiles/minimal/learning-flow/.managed-skills 20
sample/profiles/minimal/learning-flow/.template-profile 8
sample/profiles/minimal/learning-flow/.template-version 6
sample/profiles/minimal/learning-flow/AGENTS.md 3459
sample/profiles/minimal/learning-flow/AGENTS.md 2369
sample/profiles/minimal/learning-flow/MAP.md 1229
sample/profiles/minimal/learning-flow/README.md 1974
sample/profiles/minimal/learning-flow/TAKEAWAYS.md 973
sample/README.md 2997
sample/root/AGENTS.md 1339
sample/root/AGENTS.pointer.md 296
sample/root/AGENTS.md 2102
sample/root/AGENTS.pointer.md 551
scripts/install.bat 1477
scripts/install.ps1 40236
scripts/install.sh 34910
Expand Down
Loading
Loading