Skip to content

Commit e5a22b1

Browse files
SteveBlackbeardSteveBlackbeard
committed
docs: Remove inflated marketing terms
1 parent fefe2ab commit e5a22b1

2 files changed

Lines changed: 193 additions & 108 deletions

File tree

‎.github/workflows/publish.yml‎

Lines changed: 0 additions & 41 deletions
This file was deleted.

‎README.md‎

Lines changed: 193 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -1,77 +1,203 @@
1-
# CONTINUITY LEGACY 🏛️🧬
1+
# CONTINUITY LEGACY v5.0 🏛️🧬
22

3-
> **The AI Continuity Engine & Operating System Layer.**
4-
> *Preserving the Soul of the Project across Infinite AI Sessions.*
3+
> **A Lightweight AI Continuity Framework.**
4+
> *Preserving the context and state of your project across AI sessions.*
55
66
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
77
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/release/python-380/)
8-
[![PyPI continuity-legacy](https://img.shields.io/pypi/v/continuity-legacy.svg)](https://pypi.org/project/continuity-legacy/)
9-
[![PyPI continuity-legacy-lite](https://img.shields.io/pypi/v/continuity-legacy-lite.svg)](https://pypi.org/project/continuity-legacy-lite/)
8+
[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/SteveBlackbeard/CONTINUITY-LEGACY)
109

11-
**CONTINUITY LEGACY** es un motor de gobernanza e inteligencia que elimina la pérdida de contexto en proyectos con IA. No es solo un protocolo de handoff; es la **Capa de Memoria Persistente** para el desarrollo asistido por IA.
12-
13-
*Powered by Ethernium · by X: @SteveBlackbeard*
14-
15-
---
16-
17-
## 🏗️ Choose Your Edition
18-
19-
This repository hosts two distinct, self-contained editions:
10+
**CONTINUITY LEGACY** es una herramienta práctica diseñada para que humanos e IAs colaboren en proyectos manteniendo el contexto, la visión y una verdad canónica clara. Funciona como una capa de memoria persistente ligera para el desarrollo asistido por IA, asegurando que tu asistente no pierda el hilo tras un reinicio.
2011

2112
---
2213

23-
### 🔱 [CONTINUITY LEGACY Pro](./CONTINUITY%20LEGACY%20Pro/)
24-
**`pip install continuity-legacy`**
25-
26-
The flagship industrial-grade edition with full governance, security, and intelligence.
27-
28-
| Feature | |
29-
|---|---|
30-
| Decision Engine Alpha | Proposes next strategic action automatically |
31-
| Security Guardian | Blocks pushes containing leaked API keys |
32-
| Ethernium Hub Dashboard | Real-time visual project health monitor |
33-
| Logical Immunity | Detects contradictions before they corrupt memory |
34-
| Doc Parity Guard | Ensures documentation stays in sync with code |
35-
| Vector + Graph Extensions | Semantic memory & knowledge graph (ChromaDB + NetworkX) |
36-
| Encoding Sanitizer | Auto-detects and fixes mojibake in all text files |
37-
38-
**→ [Go to Pro Edition](./CONTINUITY%20LEGACY%20Pro/README.md)**
14+
## ⚡ Novedades en la v5.0
15+
16+
Esta versión añade nuevas utilidades para el ciclo de continuidad:
17+
18+
- **Decision Engine Alpha**: El sistema ahora *piensa* y propone el siguiente paso estratégico.
19+
- **Security Guardian**: Detector de secretos integrado que bloquea fugas de API Keys.
20+
- **Ethernium Hub**: Un Dashboard visual dinámico en Blanco y Negro corporativo para monitoreo en tiempo real.
21+
- **Version LITE**: Una implementación de 60 segundos para prototipado rápido en [CONTINUITY LEGACY Lite](./CONTINUITY%20LEGACY%20Lite/).
22+
- **Extensiones Reales**: Soporte funcional para BBDD Vectoriales (ChromaDB) y Grafos de Memoria (NetworkX).
23+
24+
## What this includes
25+
- a minimal canonical memory surface
26+
- a continuity [bootstrap snapshot](file:///d:/Experimentos/CONTINUITY_LEGACY/CONTINUITY%20LEGACY/outputs/continuity/context_bootstrap_summary.json)
27+
- document [parity checks](file:///d:/Experimentos/CONTINUITY_LEGACY/CONTINUITY%20LEGACY/tools/continuity_legacy/doc_parity_check.py)
28+
- system [membership checks](file:///d:/Experimentos/CONTINUITY_LEGACY/CONTINUITY%20LEGACY/tools/continuity_legacy/system_membership_check.py)
29+
- an optional external developer layer like `PROJECTDEV/`
30+
- a strict continuity [closeout command](file:///d:/Experimentos/CONTINUITY_LEGACY/CONTINUITY%20LEGACY/tools/continuity_legacy/run_continuity_cycle.py)
31+
- a [bootstrapper](file:///d:/Experimentos/CONTINUITY_LEGACY/CONTINUITY%20LEGACY/tools/continuity_legacy/bootstrap_project.py) to personalize the template
32+
33+
## Quick Start
34+
35+
### 1. The "Pro" Way (CLI) - RECOMMENDED
36+
Install the global CLI to initialize projects in one step:
37+
38+
```powershell
39+
pip install continuity-legacy
40+
continuity-legacy init "My Project"
41+
```
42+
43+
### 2. Fast Step
44+
Fast step five to the new agent `AGENT_START.md` (One step)
45+
or
46+
47+
### 3. Manual Control (Copy/Paste)
48+
1. Copy this folder to the root of your new project.
49+
2. Run the bootstrapper:
50+
51+
```powershell
52+
python tools/continuity_legacy/bootstrap_project.py --repo-root . --project-name "My Project" --project-slug my_project
53+
```
54+
55+
3. If you want an external continuity layer:
56+
57+
```powershell
58+
python tools/continuity_legacy/bootstrap_project.py --repo-root . --project-name "My Project" --project-slug my_project --enable-external-docs
59+
```
60+
61+
4. **New: Discovery Mode (Glass Box)**: If you are integrating into an existing project, use `--discover` to automatically scan your stack and suggest a context draft:
62+
63+
```powershell
64+
python tools/continuity_legacy/bootstrap_project.py --repo-root . --project-name "My Project" --project-slug my_project --discover
65+
```
66+
67+
4. Run the strict closeout:
68+
69+
```powershell
70+
python tools/continuity_legacy/run_continuity_cycle.py --repo-root . --strict
71+
```
72+
73+
## Core Files
74+
- `PROJECT_CONTEXT.md`
75+
- `STATE.json`
76+
- `ROADMAP.md`
77+
- `.continuity/BOOT_SEQUENCE.md`
78+
- `.continuity/CONTEXT_CONTINUITY.md`
79+
- `.continuity/LIVE_HANDOFF.md`
80+
- `.continuity/DECISIONS_LOG.md`
81+
- `.continuity/TIMELINE.md`
82+
- `continuity_legacy.json`
83+
84+
## Configuration & Metadata
85+
The `continuity_legacy.json` file controls paths and project identity.
86+
87+
By default, generated reports and snapshots include **provenance metadata** to indicate they were generated with Continuity Legacy. You can disable this by setting `"include_in_reports": false` under the `"metadata"` key in the config file.
88+
89+
```json
90+
"metadata": {
91+
"generated_by": "Continuity Legacy by Ethernium",
92+
"tool_version": "1.0.0",
93+
"creator": "@Steveblackbeard",
94+
"include_in_reports": true
95+
}
96+
```
97+
98+
## Automation & Safety (Continuity Guard)
99+
To ensure the project remains coherent without manual effort, `CONTINUITY LEGACY` includes a double-layered safety system:
100+
101+
1. **Local Guard (`pre-commit`)**: Installed by default. Uses **Soft Mode** to warn you about drift or missing markers while you work, without blocking your creative flow.
102+
2. **Border Guard (`pre-push`)**: Installed by default. Uses **Strict Mode** to **block the push** to GitHub if the continuity cycle is not 100% valid. This ensures the master/main branch is always canonical.
103+
3. **Cloud Guard (GitHub Actions)**: Validates the continuity cycle on every PR or push to the server.
104+
105+
## Resources
106+
- [🚀 Real-world Use Cases](file:///d:/Experimentos/CONTINUITY_LEGACY/USE_CASES.md)
107+
- [🛠️ Troubleshooting Guide](file:///d:/Experimentos/CONTINUITY_LEGACY/TROUBLESHOOTING.md)
108+
- [🛡️ Security Policy](file:///d:/Experimentos/CONTINUITY_LEGACY/SECURITY.md)
109+
- [🤝 Contributing Guide](file:///d:/Experimentos/CONTINUITY_LEGACY/CONTRIBUTING.md)
110+
- `/.continuity`
111+
Canonical continuity memory, handoff, timeline, decisions, and boot rules.
112+
- `/.continuity/registry`
113+
Registries used by strict validation for document parity and membership.
114+
- `/.continuity/templates`
115+
Template support surfaces for optional generated layers.
116+
- `/tools`
117+
Operational entry lane for the toolkit.
118+
- `/tools/continuity_legacy`
119+
User-facing automation commands such as bootstrap, sync, checks, and strict closeout.
120+
- `/tools/continuity_legacy/core`
121+
Shared helpers used by the user-facing automation commands.
122+
- `/outputs`
123+
Generated outputs lane.
124+
- `/outputs/continuity`
125+
Continuity reports and bootstrap snapshots written by automation.
126+
- `/examples`
127+
Safe place for test copies or demo instantiations.
128+
129+
## What To Hand An Agent
130+
Passing only `PROJECT_CONTEXT.md` is not enough for a full reconstruction.
131+
132+
If you want a single first file, hand the agent:
133+
- `AGENT_START.md`
134+
135+
For a real agent handoff, use this boot packet:
136+
1. `PROJECT_CONTEXT.md`
137+
2. `.continuity/BOOT_SEQUENCE.md`
138+
3. `STATE.json`
139+
4. `ROADMAP.md`
140+
5. `.continuity/LIVE_HANDOFF.md`
141+
142+
If you must give only one file first, give `PROJECT_CONTEXT.md`, but the next file should immediately be `.continuity/BOOT_SEQUENCE.md`.
143+
144+
### Resuming an Existing Project
145+
If the project already has code and active implementation:
146+
1. Hand the new agent `AGENT_START.md`.
147+
2. The agent will detect the existing `STATE.json` and `.continuity/` folder.
148+
3. The agent will calculate the exact stopping point from `LIVE_HANDOFF.md`.
149+
4. The agent is required to re-state the **Next Exact Action** to confirm alignment before writing any new code.
150+
151+
## Survival Guide: How to keep Continuity alive
152+
Continuity is a living system. If ignored, its value degrades.
153+
154+
1. **Be Honest in `STATE.json`**: If you just broke something, update the state to reflect it. Don't hide debt.
155+
2. **Next Exact Action is Sacred**: The next agent needs to know exactly where to click or what to write first.
156+
3. **Commit often, Cycle often**: Running the cycle is fast. Use it to catch drift early.
157+
158+
## Anti-Patterns: What NOT to do
159+
- ✘ **The "Just this once" skip**: Skipping the cycle when you're in a hurry is the first step toward project amnesia.
160+
- ✘ **Markdown Overload**: Don't treat `PROJECT_CONTEXT.md` as a wiki. Keep it as governing rules. Use the `[include: path/to/file.md]` feature for modularity.
161+
- ✘ **Ignoring the Hook**: If the Git Hook warns you, don't ignore it. It's your safety net.
162+
163+
## Commands (v2.0)
164+
```powershell
165+
# High-level health dashboard
166+
python tools/continuity_legacy/continuity_status.py
167+
168+
# Assisted updates based on git changes
169+
python tools/continuity_legacy/continuity_suggest.py
170+
171+
# Standard cycles & checks
172+
python tools/continuity_legacy/run_continuity_cycle.py --repo-root . --strict
173+
python tools/continuity_legacy/bootstrap_project.py --repo-root .
174+
```
175+
- `--strict`: Block on any inconsistency.
176+
- `--soft` (default): Warn but continue.
177+
178+
## Usage Rule
179+
After any relevant structural, canonical, or continuity change, finish with:
180+
181+
```powershell
182+
python tools/continuity_legacy/run_continuity_cycle.py --repo-root .
183+
```
184+
Check your dashboard:
185+
```powershell
186+
python tools/continuity_legacy/continuity_status.py
187+
```
188+
189+
## International Versions 🌍
190+
Access the documentation in your preferred language:
191+
192+
- [English (EN)](file:///d:/Experimentos/CONTINUITY_LEGACY/OTHER_LANGUAGES/en/README.md)
193+
- [Español (ES)](file:///d:/Experimentos/CONTINUITY_LEGACY/OTHER_LANGUAGES/es/README.md)
194+
- [日本語 (JA)](file:///d:/Experimentos/CONTINUITY_LEGACY/OTHER_LANGUAGES/ja/README.md)
195+
- [Русский (RU)](file:///d:/Experimentos/CONTINUITY_LEGACY/OTHER_LANGUAGES/ru/README.md)
196+
- [中文 (ZH)](file:///d:/Experimentos/CONTINUITY_LEGACY/OTHER_LANGUAGES/zh/README.md)
197+
- [Français (FR)](file:///d:/Experimentos/CONTINUITY_LEGACY/OTHER_LANGUAGES/fr/README.md)
198+
- [Italiano (IT)](file:///d:/Experimentos/CONTINUITY_LEGACY/OTHER_LANGUAGES/it/README.md)
199+
- [Deutsch (DE)](file:///d:/Experimentos/CONTINUITY_LEGACY/OTHER_LANGUAGES/de/README.md)
200+
- [Nederlands (NL)](file:///d:/Experimentos/CONTINUITY_LEGACY/OTHER_LANGUAGES/nl/README.md)
39201

40202
---
41-
42-
### ⚡ [CONTINUITY LEGACY Lite](./CONTINUITY%20LEGACY%20Lite/)
43-
**`pip install continuity-legacy-lite`**
44-
45-
Zero-overhead rapid-start edition for personal projects and prototyping.
46-
47-
| Feature | |
48-
|---|---|
49-
| Zero Dependencies | Pure Python 3 standard library only |
50-
| 60-second setup | Three files + one command |
51-
| Git Native | Auto-detects branch and commit |
52-
| AI-First | Optimized context handoff between sessions |
53-
54-
**→ [Go to Lite Edition](./CONTINUITY%20LEGACY%20Lite/README.md)**
55-
56-
---
57-
58-
## 📊 Edition Comparison
59-
60-
| Feature | Pro | Lite |
61-
|---|:---:|:---:|
62-
| Governance | ✅ Rigorous | 🔸 Flexible |
63-
| Security Scanning | ✅ Active | ❌ Manual |
64-
| Visual Dashboard | ✅ HTML Hub | ❌ CLI only |
65-
| Decision Engine | ✅ Alpha | ❌ |
66-
| Dependencies | Minimal | **Zero** |
67-
| Best for | Production projects | Experiments & prototypes |
68-
69-
---
70-
71-
## 🧠 Why CONTINUITY LEGACY?
72-
73-
In the age of AI-assisted development, the biggest bottleneck is **context loss** between sessions. This framework solves it by creating a "Canonical Truth" that survives chat restarts, agent changes, and human context gaps.
74-
75-
---
76-
77-
*© 2026 Ethernium · MIT License*
203+
*Created by Ethernium. Optimized for AI-Human pair programming.*

0 commit comments

Comments
 (0)