Skip to content

Commit 4d2e2cc

Browse files
Merge pull request #16 from diazMelgarejo/ecc-tools/periscope-1785246953340
feat: add periscope ECC bundle
2 parents e5affe8 + 0544ccf commit 4d2e2cc

3 files changed

Lines changed: 107 additions & 10 deletions

File tree

.agents/skills/periscope/SKILL.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,13 +38,16 @@ export function getUserProfile(id: string) {
3838

3939
- Use Conventional Commits.
4040
- Choose the prefix that describes the change; observed prefixes include
41-
`build`, `chore`, and `fix`.
41+
`build`, `chore`, `docs`, `fix`, and scoped variants such as
42+
`fix(frontend)` and `fix(desktop)`.
4243
- Keep the subject concise and include a scope when it adds useful context.
4344

4445
```text
4546
build(deps): update frontend dependencies
4647
fix(desktop): honor PERISCOPE_VERSION override
4748
chore(git): sync attribution guard scripts
49+
docs: align layer-2 synthesis analysis tip SHA
50+
fix(frontend): remove stale ActivityMinimap and pass svelte-check
4851
```
4952

5053
## Workflows
@@ -82,6 +85,20 @@ chore(git): sync attribution guard scripts
8285
4. Run the checks for each affected subsystem.
8386
5. Commit the manifest and lockfile together with a `build(deps)` subject.
8487

88+
### Integration Analysis Doc
89+
90+
**Trigger:** When updating layer-2 integrative synthesis verification or tip SHA
91+
92+
**Guide:** `/update-integration-analysis`
93+
94+
**Instinct:** `periscope-workflow-update-integration-analysis-doc` — numbered
95+
workflow steps; trigger: "when doing update integration analysis doc".
96+
97+
1. Edit `docs/INTEGRATION-SYNTHESIS-LAYER2-ANALYSIS.md` for verification gates,
98+
branch references, or tip SHA alignment.
99+
2. Use a `docs:` Conventional Commit subject that names the alignment work.
100+
3. Keep the analysis consistent with the current `merged` integration line.
101+
85102
### Testing
86103

87104
**Trigger:** When verifying correctness

.claude/homunculus/instincts/inherited/periscope-instincts.yaml

Lines changed: 71 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,14 @@
11
# Instincts generated from https://github.com/diazMelgarejo/periscope
22
# Generated: 2026-07-28T00:55:34.446Z
33
# Harmonized with ECC run: 2026-07-28T01:26:19.263Z
4+
# Additive replay from ECC run: 2026-07-28T13:55:47.517Z (PR #16 on merged)
45
# Version: 2.0
56
# Absorbed ID aliases from the second run:
67
# - periscope-instinct-commit-format -> periscope-instinct-git-commit-format
78
# - periscope-instinct-commit-length -> periscope-instinct-git-commit-length
9+
# Additive instincts from PR #16 (no amputation of PR #10/#12 synthesis):
10+
# - periscope-arch-type-based
11+
# - periscope-workflow-update-integration-analysis-doc
812
# NOTE: This file supplements (does not replace) any existing curated instincts.
913
# High-confidence manually curated instincts should be preserved alongside these.
1014

@@ -290,6 +294,29 @@ Prefer named exports where the surrounding frontend module follows that pattern.
290294

291295
- Pattern in codeStyle.exportStyle
292296

297+
---
298+
id: periscope-arch-type-based
299+
trigger: "when adding new code"
300+
confidence: 0.8
301+
domain: architecture
302+
source: repo-analysis
303+
source_repo: https://github.com/diazMelgarejo/periscope
304+
---
305+
306+
# Periscope Arch Type Based
307+
308+
## Action
309+
310+
Place code in the appropriate type folder for the affected subsystem, such as
311+
`frontend/src/lib/components/`, Go `internal/` packages, `cmd/` entrypoints, or
312+
`desktop/src-tauri/src/`.
313+
314+
## Evidence
315+
316+
- Type-based module organization detected across Go, frontend, and desktop
317+
- Observed folders: `frontend/src/lib/components/`, `internal/`, `cmd/`,
318+
`desktop/src-tauri/src/`
319+
293320
---
294321
id: periscope-instinct-git-commit-format
295322
trigger: "When writing a commit message"
@@ -304,14 +331,17 @@ source_repo: diazMelgarejo/periscope
304331
## Action
305332

306333
Use Conventional Commits with a prefix that matches the change. Observed
307-
prefixes include `build`, `chore`, and `fix`.
334+
prefixes include `build`, `chore`, `docs`, `fix`, and scoped variants such as
335+
`fix(frontend)` and `fix(desktop)`.
308336

309337
## Evidence
310338

311-
- Pattern in commits.prefixes
339+
- Pattern in commits.prefixes across ECC runs and layer-2 integration work
312340
- Examples: 'build(deps): bump marked, svelte, postcss in frontend',
313341
'chore(git): sync attribution guard scripts and cursor rules',
314-
'fix(desktop): test PERISCOPE_VERSION override'
342+
'fix(desktop): test PERISCOPE_VERSION override',
343+
'docs: integrative synthesis layer-2 on origin/merged',
344+
'fix(frontend): remove stale ActivityMinimap and pass svelte-check'
315345

316346
---
317347
id: periscope-instinct-git-commit-length
@@ -326,14 +356,16 @@ source_repo: diazMelgarejo/periscope
326356

327357
## Action
328358

329-
Keep the commit subject concise and descriptive; the richer ECC sample averaged
330-
approximately 68 characters.
359+
Keep the commit subject concise and descriptive. Observed averages range from
360+
approximately 55 characters (layer-2 integration commits) to 68 characters (the
361+
richer ECC sample).
331362

332363
## Evidence
333364

334-
- Pattern in commits.averageLength
335-
- The first input observed 59 characters across 1 commit; the second observed
336-
68 characters across 4 commits
365+
- Pattern in commits.averageLength across ECC runs and layer-2 integration work
366+
- First ECC input: 59 characters across 1 commit
367+
- Second ECC input: 68 characters across 4 commits
368+
- Layer-2 integration line: 55 characters across 6 commits
337369

338370
---
339371
id: periscope-instinct-test-location
@@ -388,3 +420,34 @@ committing the dependency state together.
388420
- Commit example: 'build(deps): bump marked, svelte, postcss in frontend
389421
(onto merged)'
390422

423+
---
424+
id: periscope-workflow-update-integration-analysis-doc
425+
trigger: "when doing update integration analysis doc"
426+
confidence: 0.7
427+
domain: workflow
428+
source: repo-analysis
429+
source_repo: https://github.com/diazMelgarejo/periscope
430+
---
431+
432+
# Periscope Workflow Update Integration Analysis Doc
433+
434+
## Action
435+
436+
Follow the update-integration-analysis-doc workflow:
437+
1. Edit `docs/INTEGRATION-SYNTHESIS-LAYER2-ANALYSIS.md` to update verification
438+
status, tip SHA, or branch reference.
439+
2. Commit with a descriptive `docs:` subject referencing the alignment work.
440+
441+
## Related
442+
443+
- Layer-2 recovery branch documents the integrative synthesis technique used
444+
alongside this workflow.
445+
- Skill guide: `/update-integration-analysis` in `.agents/skills/periscope/SKILL.md`
446+
and `.claude/skills/periscope/SKILL.md`.
447+
448+
## Evidence
449+
450+
- Workflow detected from layer-2 integration commit patterns
451+
- Observed file: `docs/INTEGRATION-SYNTHESIS-LAYER2-ANALYSIS.md`
452+
- Frequency: episodic during integrative merge and recovery work
453+

.claude/skills/periscope/SKILL.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,13 +38,16 @@ export function getUserProfile(id: string) {
3838

3939
- Use Conventional Commits.
4040
- Choose the prefix that describes the change; observed prefixes include
41-
`build`, `chore`, and `fix`.
41+
`build`, `chore`, `docs`, `fix`, and scoped variants such as
42+
`fix(frontend)` and `fix(desktop)`.
4243
- Keep the subject concise and include a scope when it adds useful context.
4344

4445
```text
4546
build(deps): update frontend dependencies
4647
fix(desktop): honor PERISCOPE_VERSION override
4748
chore(git): sync attribution guard scripts
49+
docs: align layer-2 synthesis analysis tip SHA
50+
fix(frontend): remove stale ActivityMinimap and pass svelte-check
4851
```
4952

5053
## Workflows
@@ -82,6 +85,20 @@ chore(git): sync attribution guard scripts
8285
4. Run the checks for each affected subsystem.
8386
5. Commit the manifest and lockfile together with a `build(deps)` subject.
8487

88+
### Integration Analysis Doc
89+
90+
**Trigger:** When updating layer-2 integrative synthesis verification or tip SHA
91+
92+
**Guide:** `/update-integration-analysis`
93+
94+
**Instinct:** `periscope-workflow-update-integration-analysis-doc` — numbered
95+
workflow steps; trigger: "when doing update integration analysis doc".
96+
97+
1. Edit `docs/INTEGRATION-SYNTHESIS-LAYER2-ANALYSIS.md` for verification gates,
98+
branch references, or tip SHA alignment.
99+
2. Use a `docs:` Conventional Commit subject that names the alignment work.
100+
3. Keep the analysis consistent with the current `merged` integration line.
101+
85102
### Testing
86103

87104
**Trigger:** When verifying correctness

0 commit comments

Comments
 (0)