Repository navigation
Align delivery onboarding and branding with the CompleteTech Skills package #1
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.
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
Merged
Changes from all commits
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
7989209
feat: align delivery with CompleteTech Skills package contract
CompleteDotTech 131ecc3
feat: apply shared branding, handoff and cross-platform package stand…
CompleteDotTech 6c547d3
fix: synchronize reviewed package edge cases and verification guidance
CompleteDotTech File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,10 @@ | ||
| root = true | ||
|
|
||
| [*] | ||
| charset = utf-8 | ||
| end_of_line = lf | ||
| insert_final_newline = true | ||
|
|
||
| [*.py] | ||
| indent_style = space | ||
| indent_size = 4 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| ## Change and affected skills | ||
|
|
||
| Describe the user-visible change, sibling dependencies and compatibility impact. | ||
|
|
||
| ## Evidence | ||
|
|
||
| Record commands, results and exact tested commit. Distinguish structural checks, runtime tests and visual review. Name checks not run and why. | ||
|
|
||
| ## Boundaries | ||
|
|
||
| Confirm that activation keys, consent, private assets, approval gates and specialist entry points remain intact. Identify any intentional exception. No registry release, visibility change or live external action is implied. | ||
|
|
||
| ## Family consistency | ||
|
|
||
| For shared changes, identify affected sibling PRs and the orchestrator drift-audit result. Do not claim coordinated merge until each PR is confirmed merged. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,23 @@ | ||
| name: Package contract | ||
| on: [push, pull_request] | ||
| permissions: | ||
| contents: read | ||
| jobs: | ||
| validate-package: | ||
| strategy: | ||
| fail-fast: false | ||
| matrix: | ||
| os: [ubuntu-latest, windows-latest, macos-latest] | ||
| runs-on: ${{ matrix.os }} | ||
| timeout-minutes: 5 | ||
| steps: | ||
| - uses: actions/checkout@v4 | ||
| with: | ||
| persist-credentials: false | ||
| - uses: actions/setup-python@v5 | ||
| with: | ||
| python-version: '3.12' | ||
| - name: Test the package contract | ||
| run: python -m unittest discover -s tests -p 'test_package_*.py' -v | ||
| - name: Validate the full checkout | ||
| run: python scripts/validate_package.py |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,9 @@ | ||
| # CompleteTech LLC Skills: maintainer instructions | ||
|
|
||
| Read [SKILL.md](SKILL.md) for specialist behavior, [ONBOARDING.md](ONBOARDING.md) for first use, [BRANDING.md](BRANDING.md) for presentation and handoffs, and [CONTRIBUTING.md](CONTRIBUTING.md) before changing this checkout. | ||
|
|
||
| Preserve the activation key, existing CLI paths, templates, dependencies, approval gates and consent boundaries. A common package does not require identical generators. Keep private assets private and use synthetic fixtures. Never scan personal logs, submit certificate data, install schedules, send messages or publish artifacts merely to test alignment. | ||
|
|
||
| Run `python -m unittest discover -s tests -p 'test_package_*.py' -v` and `python scripts/validate_package.py`, then the existing Quality checks. Do not disable failing checks or replace verified evidence with successful rendering. Describe any checks not run. | ||
|
|
||
| Shared files are maintained together through the orchestrator's catalog and drift audit. Update affected siblings in focused PRs; review exact heads and checks before merging. Registry publishing and visibility changes are separate actions. Never claim a PR exists or merged without its successful GitHub response. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,30 @@ | ||
| # CompleteTech LLC Skills: branding and handoffs | ||
|
|
||
| [Start here](ONBOARDING.md) · [Asset rights](BRAND_ASSETS.md) · [Specialist instructions](SKILL.md) | ||
|
|
||
| ## Resolve identity before rendering | ||
|
|
||
| An approved engagement brand takes precedence over a starter example. Preserve the operator's explicit settings; ask about unresolved identity instead of silently applying company branding. The ledger remains neutral by default. CompleteTech examples identify this library, not permission to represent another business. | ||
|
|
||
| Use the existing local `assets/logo.png` for authorized CompleteTech output. Do not synthesize replacement marks, fetch remote artwork, redistribute fonts, or transfer private seals/signatures to public repositories. The MIT code license does not replace the asset policy. | ||
|
|
||
| ## Starter palette | ||
|
|
||
| These established library colors are a reference, not new runtime defaults: | ||
|
|
||
| | Token | Value | | ||
| |---|---| | ||
| | Accent | `#1E3A8A` | | ||
| | Ink | `#0F172A` | | ||
| | Soft accent | `#EEF2FF` | | ||
| | Muted text | `#64748B` | | ||
| | Border | `#E2E8F0` | | ||
| | Alternating row | `#F8FAFC` | | ||
|
|
||
| Keep specialist layouts: invoices, envelopes, certificates, proposals and dashboards have different constraints. Use existing renderer options, generator configuration or the ledger's explicit branding preset, as documented in this skill's README and `--help`. This document does not introduce a universal brand-import flag. | ||
|
|
||
| ## Handoff to the next skill | ||
|
|
||
| Carry verified facts and their sources, artifact path/version, approved identity and local logo path, palette overrides, confidentiality, intended audience, approval owner/status, blockers and next specialist. Preserve these in the orchestrator's existing `project_state`; do not replace its workflow schema with an incompatible parallel state format. | ||
|
|
||
| Missing approval stays unknown or draft. Rendering, anonymization, a clean package check or a reused brand does not authorize sending, publication, billing, signing, attendance claims or launch. Review the actual output for clipping, contrast, placeholders and factual accuracy before approved use. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,30 @@ | ||
| # Contributing to CompleteTech LLC Skills | ||
|
|
||
| [Start here](ONBOARDING.md) · [Branding and handoffs](BRANDING.md) · [Maintainer instructions](AGENTS.md) · [Specialist instructions](SKILL.md) | ||
|
|
||
| ## Compatibility | ||
|
|
||
| Keep each skill independently usable. Preserve activation keys, root generator CLIs, templates, runtime dependencies, consent and approval gates. The ledger's standard-library core and neutral branding are intentional differences, not gaps to remove. | ||
|
|
||
| ## Verification | ||
|
|
||
| From a full checkout using Python 3.12, the package CI baseline: | ||
|
|
||
| ```bash | ||
| python -m unittest discover -s tests -p 'test_package_*.py' -v | ||
| python scripts/validate_package.py | ||
| ``` | ||
|
|
||
| Also run the existing full Quality gate after installing its documented development tools: | ||
|
|
||
| ```bash | ||
| python scripts/validate_quality.py | ||
| ``` | ||
|
|
||
| The repository's `QUALITY.md` and [README.md](README.md) describe additional specialist checks and dependencies. Package checks are read-only and do not execute specialist generators. Their link scan covers ordinary inline destinations in ONBOARDING.md, CONTRIBUTING.md, BRANDING.md and AGENTS.md, not the entire documentation tree, reference-style links, HTML or anchor validity. PNG checks cover bounded chunk structure and CRC integrity, not decompression, pixel decoding or artwork. The full Quality gate and visual review remain separate. Do not weaken original Quality checks to obtain a green result. | ||
|
|
||
| ## Coordinated changes | ||
|
|
||
| Keep `skill-package.json`, onboarding and actual entry points synchronized. Shared validator, tests, CI, maintainer instructions and branding guidance must match the orchestrator's shared-file audit. Use focused PRs and report exact checks, failures and limitations. Respect branch protection, review requirements and changed heads. | ||
|
|
||
| Use synthetic fixtures and new output paths instead of overwriting committed previews. Never commit secrets, personal logs, real account mappings, client documents or unapproved quotes. Code remains under [LICENSE](LICENSE); branding remains under [BRAND_ASSETS.md](BRAND_ASSETS.md). Do not redistribute private assets or fonts. Registry releases and repository visibility changes require separate authorization. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,64 @@ | ||
| # Start here: agentic-delivery-skill | ||
|
|
||
| <p align="center"><img src="assets/logo.png" alt="CompleteTech LLC logo" width="260"></p> | ||
|
|
||
| **CompleteTech LLC Skills** — Kickoff, execution, evaluation and handoff. | ||
|
|
||
| [Overview](README.md) · [Agent instructions](SKILL.md) · [Contributing](CONTRIBUTING.md) · [Skill library](https://github.com/CompleteTech-LLC/agentic-services-orchestrator-skill/blob/main/references/skill-family.md) | ||
|
|
||
| ## 1. Choose the right skill | ||
|
|
||
| This is a `catalog-renderer`. Its install/activation key is **`agentic-delivery-skill`**. Use the orchestrator when work spans multiple specialists; install only the specialists the engagement needs. Install the complete skill directory, including `SKILL.md`, references, scripts and assets, in the directory supported by your agent. Do not install only the Markdown file. Keep this skill separate from its siblings. | ||
|
|
||
| ## 2. Get a full checkout and prepare Python | ||
|
|
||
| Python 3.12 is the shared CI baseline. Git is needed only for cloning. The full GitHub checkout includes the existing brand assets; text-only registry packages can omit binary logos/previews and are not the target of the checkout validator. | ||
|
|
||
| ```bash | ||
| git clone https://github.com/CompleteTech-LLC/agentic-delivery-skill.git agentic-delivery-skill | ||
| cd agentic-delivery-skill | ||
| python3 -m venv .venv | ||
| . .venv/bin/activate | ||
| python -m pip install -r requirements.txt | ||
| python scripts/validate_package.py | ||
| ``` | ||
|
|
||
| On Windows PowerShell, create the environment with `py -3 -m venv .venv`, then use `.\.venv\Scripts\python.exe` instead of `python` in subsequent commands. Activation is optional; do not change machine execution policy for this skill. For an existing checkout, skip `git clone` and start at environment setup. | ||
|
|
||
| ## 3. Run a safe demonstration | ||
|
|
||
| Run from the skill root. The commands below use bundled synthetic/example inputs, not client data. They can replace an earlier demonstration at the same output path; choose a new filename when retaining prior output. | ||
|
|
||
| ```bash | ||
| python scripts/render_delivery.py --list | ||
| python scripts/render_pdf.py --markdown assets/examples/example.md --out output/onboarding-demo.pdf --logo assets/logo.png --title "Onboarding demonstration" | ||
| ``` | ||
|
|
||
| The catalog lists available templates; the second command renders the bundled demonstration Markdown to `output/onboarding-demo.pdf`. This is a rendering smoke test, not approval of its illustrative facts. | ||
|
|
||
| Open the generated output and inspect page breaks, tables, logo, text and any remaining placeholders. Package validation checks structure; it does not certify visual quality or factual correctness. Committed previews in `assets/examples/` are references, not destinations for your first run. | ||
|
|
||
| ## 4. Use the skill with your agent | ||
|
|
||
| Read [SKILL.md](SKILL.md), select `agentic-delivery-skill` using your agent's skill activation mechanism, and provide verified inputs, the requested artifact, destination and required approval owners. Agent discovery paths differ by product; follow that product's installation documentation rather than assuming one global path. Do not grant broader permissions simply because multiple skills are installed together. | ||
|
|
||
| ## Branding and handoff | ||
|
|
||
| Use the existing CompleteTech LLC logo and the practical, evidence-led voice described in [README.md](README.md). The code license does not grant logo, seal or signature rights: follow [BRAND_ASSETS.md](BRAND_ASSETS.md). Do not replace or republish private artwork or fonts. | ||
|
|
||
| For a multi-skill handoff, preserve the source facts, artifact paths, approval owner/status, blockers and next specialist in the orchestrator's existing `project_state` schema. Do not treat a generated artifact, anonymization or successful check as permission to send, publish, bill, sign, award or launch. | ||
|
|
||
| ## Safety and permissions | ||
|
|
||
| The documented generation workflow is local. Installation may contact GitHub and package indexes, but generation does not send messages, move money, publish documents, grant approval or install background services. Review the specialist boundaries in [SKILL.md](SKILL.md) before using real inputs. | ||
|
|
||
| ## Troubleshooting and verification | ||
|
|
||
| A missing module usually means the active interpreter differs from the one used for `pip`; use `python -m pip` in the same environment and this repository's `requirements.txt`. Missing logos or references usually indicate a partial/text-only installation or the wrong working directory; use a full checkout and run from its root. Do not download replacement branding from unrelated sources. | ||
|
|
||
| ```bash | ||
| python -m unittest discover -s tests -p test_package_contract.py -v | ||
| python scripts/validate_package.py | ||
| ``` | ||
|
|
||
| These checks use the standard library and do not execute the listed generators, scan accounts, contact services or install schedules. Follow [CONTRIBUTING.md](CONTRIBUTING.md) and the repository's existing quality instructions for the additional runtime, rendering, parser and diagram checks. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The onboarding command restricts discovery to
test_package_contract.py, whereas the package CI and maintainer command intentionally usetest_package_*.py. As soon as another contract test module is added under that established naming convention, users following onboarding will silently skip it; use the same wildcard command as CI.AGENTS.md reference: AGENTS.md:L7-L7
Useful? React with 👍 / 👎.