Skip to content

generic-automation-and-it/smooth-ai-stockanalysis / .agents/skills/ai-template-sync

ai-template-sync

Verified

UPSERT the smooth-ai-stockanalysis agentic scaffold into an existing repo. Asks which tools (Claude Code, Codex, Copilot) to configure, whether to copy .NET solutioning, and whether to overwrite existing agentic files.

FileKindSize
AGENTS.mdmarkdown2.3 KB
SKILL.mdskill md11.8 KB
agents/openai.yamlconfig375 B
scripts/sync.ps1executablescript8.1 KB
scripts/sync.shexecutablescript7.5 KB
# ai-template-sync — AGENTS.md

## TL;DR

UPSERT distributor for the agentic scaffold: all decisions (tools, overwrite scope, dotnet) stay with the agent; all file mechanics live in `scripts/sync.sh` / `sync.ps1`, which must stay behaviorally identical.

## Non-Negotiables

- **Keep `sync.sh` and `sync.ps1` in lockstep.** Every flag and section added to one MUST be added to the other in the same change — Windows consumers get the `.ps1` path only.
- **Never add deletion of landing-only files** to any section or mode. The contract is UPSERT; `--overwrite global` means "replace same-named files", never "mirror the template".
- **Dotnet files are add-only** (`Section E`) — no overwrite path may ever be introduced, even behind a flag.

## Architecture Decisions

- **LADR-001** (2026-06-12, accepted): `--rules-only` is the supported channel for distributing this repo's rule system to other repositories (a "rules package manager"). *Context:* no AI tool has a native cross-tool rules marketplace; Claude plugins/Copilot org-instructions each cover one tool. *Decision:* extend the existing sync script (which already owns the symlink contract and overwrite safety) instead of per-tool marketplace wrappers; pin versions via `--template-ref`. *Consequence:* the Phase 2 rules-layout pre-flight is enforced **in the script** for this mode (refuses a real `.agents/rules` dir, exit 65); marketplace wrappers, if ever built, must shell out to `sync.sh --rules-only` rather than reimplement copying.

## Key Behaviors

- Section D (`copilot` in `--tools`) replaces `.github/instructions/` and re-points the `.agents/rules` symlink — this is the one destructive-looking step, which is why SKILL.md Phase 2 runs even in Global mode and why the script refuses when `.agents/rules` is a real directory.
- `--template-ref` falls back from `git clone --branch` (tags/branches) to full-clone + detached checkout (SHAs); a failed shallow attempt is silently retried, so a slow pinned clone is expected for SHA pins.
- `sync.ps1` ends rules-only mode with `return` inside `try` — the `finally` block still removes the temp clone; don't convert it to `exit`.

## Changelog

| Date | Change | Ref |
|:-----|:-------|:----|
| 2026-06-12 | Initial version. Added `--rules-only` / `--template-ref` rules-distribution mode to both scripts; Phase 0 compressed to use `--template-url` self-acquire. | |
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall