Skip to content

feat: split ailss agent skill architecture and installer workflow#73

Open
maehwasoo wants to merge 5 commits into
mainfrom
feat/issue-58-agent-split
Open

feat: split ailss agent skill architecture and installer workflow#73
maehwasoo wants to merge 5 commits into
mainfrom
feat/issue-58-agent-split

Conversation

@maehwasoo
Copy link
Copy Markdown
Owner

What

  • Split Codex skill snapshots into ailss-agent + ailss-agent-ontology + ailss-agent-curator + ailss-agent-maintenance.
  • Kept ailss-prometheus-agent as a one-release compatibility shim and updated Codex-skill docs references.
  • Reduced vault prompt installer output to a concise operational prompt that references dedicated ontology standards docs.
  • Added Obsidian plugin Codex skill installer flow (install path settings, overwrite/backup options, clipboard fallback, install command).
  • Added typed-link SoT consistency checks across code/docs/skills and removed duplicated typed-link key list in MCP template rendering.

Why

How

  • Added new skill snapshots under docs/ops/codex-skills/* and updated legacy shim content.
  • Added ontology docs split (typed-links-relation-catalog.md, typed-links-decision-tree.md, typed-links-governance.md) and repurposed typed-links.md as an index.
  • Added prompt-operational.md and switched plugin prompt bundling to this concise prompt source.
  • Implemented plugin install/copy plumbing in settings.ts, main.ts, registerCommands.ts, and new codexSkillInstaller.ts.
  • Extended packages/mcp/test/docs.mcpToolingConsistency.test.ts to assert typed-link key parity and updated ailssNoteTemplate.ts to use AILSS_TYPED_LINK_KEYS directly.
  • Validated with pnpm format:check, pnpm lint, pnpm typecheck, pnpm typecheck:repo, and pnpm test.

@maehwasoo maehwasoo added docs Improvements or additions to documentation enhancement New feature or request plugin Obsidian plugin mcp MCP server labels Feb 9, 2026
@maehwasoo maehwasoo self-assigned this Feb 9, 2026
…plit

# Conflicts:
#	docs/ops/codex-skills/prometheus-agent/SKILL.md
#	docs/standards/vault/frontmatter-schema.md
#	docs/standards/vault/typed-links.md
#	packages/mcp/src/lib/ailssNoteTemplate.ts
#	packages/obsidian-plugin/src/settings.ts
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f6b990775e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +19 to +22
- `typed-links.md` (index)
- `typed-links-relation-catalog.md` (relation semantics)
- `typed-links-decision-tree.md` (selection rules)
- `typed-links-governance.md` (SoT + change process)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Point ontology references to actual vault doc paths

The prompt installer now ships only prompt-operational.md (packages/obsidian-plugin/src/utils/promptTemplates.ts), but these references are bare filenames that do not match the repository layout where the canonical docs live under docs/standards/vault/. After installing the prompt at the vault root, assistants are directed to paths that typically do not exist, which breaks the intended follow-up guidance for typed-link decisions and governance; these should be written as repository-relative paths (for example, docs/standards/vault/...).

Useful? React with 👍 / 👎.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 454f686c75

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

1. Pull candidates with `get_context`.
2. Verify exact source/target wording via `resolve_note` + `read_note`.
3. Inspect graph context with `expand_typed_links_outgoing` and optional incoming checks.
4. Update frontmatter with `improve_frontmatter` or `edit_note`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Gate ontology skill write steps behind write-tool availability

This workflow instructs users to apply improve_frontmatter/edit_note unconditionally, but MCP write tools are disabled by default in AILSS deployments, so following the skill in the default setup will trigger deterministic tool-call failures instead of a usable read-only flow. The previous core skill explicitly marked write tools as conditional; the new modular skills should do the same (or provide a read-only fallback path) to avoid breaking default Codex sessions.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to documentation enhancement New feature or request mcp MCP server plugin Obsidian plugin

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: split AILSS agent/prompt/install architecture for ontology hardening

1 participant